Virtio-win guest tools installer

Introduction:

Virtio-win guest tools installer is a msi (Microsoft installer) created with Wix Toolset which installs:

Virtio-win drivers - KVM/QEMUY windows guest drivers for both paravirtual and emulated hardware, more on Github Repo.

Spice guest agent and driver - Spice is an open remote computing solution, providing client access to remote machine display and devices, more info on the Offical website.

The installer is distributed as part of virtio-win package on Fedora.

Building from sources:

The installer can be built in two ways, using oVirt CI mock runner tool and a manual build using make.

Prerequsits:

Before buidling the installer you must have the virtio-win drivers localy on the format which they are distributed on the iso:

|-Balloon['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k3', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1', 'xp']
|-NetKVM['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k3', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1', 'xp']
|-pvpanic['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1']
|-fwcfg['2k12', '2k12R2', '2k16', '2k19', '2k22', 'w10', 'w11', 'w8', 'w8.1']
|-qemupciserial['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1']
|-vioinput['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1']
|-viorng['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1']
|-vioscsi['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1']
|-vioserial['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k3', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1', 'xp']
|-viostor['2k12', '2k12R2', '2k16', '2k19', '2k22', '2k3', '2k8', '2k8R2', 'w10', 'w11', 'w7', 'w8', 'w8.1', 'xp']
|-viofs['2k12', '2k12R2', '2k16', '2k19', '2k22', 'w10', 'w11', 'w8', 'w8.1']
|-viogpu['2k12', '2k12R2', '2k16', '2k19', '2k22', 'w10', 'w11', 'w8', 'w8.1']

You can get it by:

• Extracting the virtio-win iso content (availabe on virtio-win rpm package).

• Run make-driver-dir.py from virtio-win-pkg-scripts github repo.

Building with Mock Runner:

1. Follow the instructions on oVirt CI mock runner docs for setting up and installing mock runner.

2. Create a soft link to the drivers directory:

   ln -sf ${VIRTIO_WIN_DRIVERS_PATH} $(pwd)/vwi 
   

3. Once mock_runner is setup, from the project root directory run:

   path/to/jenkins/mock_configs/mock_runner.sh -b fc30
   

4. The build artifacts which are 2 msis (x64, x86) and one .exe file will be on the exported artifacts directory, which was created during the build process.

Building with make:

1. Make sure all the packages on automation/build-artifacts.packages are installed on the machine, relevant repos can be found on automation/build-artifacts.repos.

2. Run the build script ./automation/build-artifacts.sh VIRTIO_WIN_DRIVERS_PATH QEMU_GA_64_MSI_PATH QEMU_GA_86_MSI_PATH VERSION

   • VIRTIO_WIN_DRIVERS_PATH - dir containing the virtio-win drivers
   • QEMU_GA_64_MSI_PATH - path to the qemu ga x64 MSI
   • QEMU_GA_86_MSI_PATH - path to the qemu ga x86 MSI
   • VERSION - version on the installer

3. The build artifacts which are 2 msis (x64, x86) and one .exe file will be on the exported artifacts directory, which was created during the build process.

Contributions:

Contributions are more than welcome, please fork the repository and create a PR.