Skip to content

gushmazuko/truenas-qemu-guest-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

TrueNAS 13 QEMU Guest Agent

This is a guide for Installing and Configuring QEMU Guest Agent for TrueNAS 13. It is based on the QEMU Guest Agent and VirtIO Console driver from FreeBSD 13.

Requirements

Due to the TrueNAS kernel lacking certain FreeBSD drivers, it's necessary to download the FreeBSD 13 kernel, extract the VirtIO Console driver and integrate it into the TrueNAS system. This ensures TrueNAS compatibility with virtualized environments.

Required packages for this guide:

FreeBSD 13 Binary Packages:

Manual Installation

  1. Download FreeBSD 13.1 kernel.txz and extract ./boot/kernel/virtio_console.ko driver to /boot/modules/ directory.

  2. Load the VirtIO Console driver with

    kldload /boot/modules/virtio_console.ko
  3. Download FreeBSD 13 QEMU Guest Agent package.

  4. Install downloaded qemu-guest-agent package using pkg add.

  5. Backup installed /usr/local/etc/rc.d/qemu-guest-agent to /root/qga_backup/. This will be a copy that is re-added to the rc.d directory each time TrueNAS boots.

  6. Create the following Tunables in the TrueNAS web UI under System -> Tunables:

    1. Variable: qemu_guest_agent_enable, Value: YES, Type: RC, Enabled: yes
    2. Variable: qemu_guest_agent_flags, Value: -d -v -l /var/log/qemu-ga.log, Type: RC, Enabled: yes
    3. Variable: virtio_console_load, Value: YES, Type: LOADER, Enabled: yes
  7. Set up Init/Shutdown Scripts in Tasks -> Init/Shutdown Scripts:

    1. Type: Command, Command: service qemu-guest-agent start, When: POSTINIT, Enabled: yes, Timeout: 10
    2. Type: Command, Command: cp /root/qga_backup/qemu-guest-agent /usr/local/etc/rc.d, When: PREINIT, Enabled: yes, Timeout: 10
  8. Reboot TrueNAS to apply changes.

Automated Installation

Via bash script:

  1. Execute the following commands on your TrueNAS system:

    curl -O https://raw.githubusercontent.com/gushmazuko/truenas-qemu-guest-agent/master/install.sh
    chmod +x install.sh
    ./install.sh
  2. Reboot TrueNAS to apply changes.

Or via ansible:

  1. Execute ansible-playbook on your TrueNAS system:

    ansible-playbook ./install_qemu_guest_agent_on_truenas.yml \
    -e working_host=truenas.example.com \
    -e ansible_ssh_port=22
  2. Reboot TrueNAS to apply changes.

Conclusion

Following these steps ensures the successful installation and configuration of the QEMU Guest Agent on TrueNAS 13, improving its functionality in virtualized environments.

Releases

No releases published

Packages

No packages published

Languages