The following covers how to deploy a virtual machine (VM) on KVM-based hypervisors.

Before installing the Software Appliance, review the System Requirements.

Note that there are various ways to deploy a virtual machine on a KVM server and the following example steps describe how to transfer and extract the downloaded files.

To proceed you can perform the steps below:

  1. Download the Software Appliance package for your hypervisor from your Keyfactor download area.

  2. Transferring the downloaded file directly to your KVM server via SCP (secure copy) to your datastore location  /var/lib/libvirt/images :

    scp Keyfactor<Ejbca/SignServer>SoftwareAppliance-x.x.x.tar.gz user@<kvm-host>:/var/lib/libvirt/images
    TEXT

  3. Next on your KVM server, extract the tar archive inside of your datastore.
    Do so by typing the command: 

    tar -xzf Keyfactor<Ejbca/SignServer>SoftwareAppliance-x.x.x.tar.gz
    TEXT
  4. Contents of the package:
    The tar file contains two disks as .qcow2 disk images with both disks thin partitioned.
    Additionally, a working sample XML definition for the Software Appliance, for KVM based hypervisors is included.
    A script for generating an XML with the following name: generateXmlDefinition.bash
    The sample XML definition file has the following name: defaultDefinition.xml

  5. Change to the directory that has been extracted.

    cd /path/to/your/datastore/KeyfactorSoftwareAppliance
    TEXT

  6. You can optionally supply the name of the VM as an argument for the script.
    If no name is supplied the default naming scheme ( Keyfactor Ejbca/SignServer Software Appliance x.x.x) is used.

    ./generateXmlDefinition.bash "YourVmNameHere"
    TEXT

    After the execution of the script, the new generatedDefinition.xml file has been generated.

  7. Now you can import the VM by running the following command:

    virsh define generatedDefinition.xml
    TEXT

    The machine is now ready to be started.

  8. Once the VM has started, log in to the Software Appliance.