QEMU-GA on OmniOS and OpenIndiana

README.md

• Install the qemu package which contains a .../bin/qemu-ga(OOCE Extra repo in case of OmniOS) among the server implementation

:; pkg install qemu

# On OmniOS also:
:; ln -s ../../opt/ooce/bin/qemu-ga /usr/bin

• Edit config file; note that the method and path depend on hypervisor-provided device (virtio-agent or ISA -- without a dedicated driver package, only the latter is actually supported), e.g.:

:; prtdiag | grep -E 'pci1af4,3|isa|asy'
:; dmesg | grep asy

### Populate config with one of examples below based on HW output above
:; mkdir -p /etc/qemu
:; vi /etc/qemu/qemu-ga.conf

• Provide an SMF service:

# Populate with text below
:; vi /lib/svc/manifest/system/qemu-ga.xml

:; svccfg import /lib/svc/manifest/system/qemu-ga.xml

:; tail -F /var/svc/log/*qemu-ga*g &

:; svcadm enable qemu-ga
:; svcadm clear qemu-ga

• Check from host, e.g. for VM ID 123:

:; qm agent 123 ping && echo OK

qemu-ga.conf.ISA

[general]
method=isa-serial
path=/devices/pci@0,0/isa@1/asy@1,3f8:a
#MAYBE# path=/dev/ttya
#MAYBE# path=/devices/pci@0,0/isa@1/asy@1,2f8:b
#MAYBE# path=/dev/ttyb
daemon=false
pidfile=/var/run/qemu-ga.pid
logfile=/var/log/qemu-ga.log
statedir=/var/run
verbose=false
blacklist=

qemu-ga.conf.VIRTIO

[general]
method=virtio-serial
### May need a kernel driver for virtio, would be something like:
path=/devices/pci@0,0/pci1b36,1@5/pci1af4,3@1:a
daemon=false
pidfile=/var/run/qemu-ga.pid
logfile=/var/log/qemu-ga.log
statedir=/var/run
verbose=false
blacklist=

qemu-ga.xml

<?xml version='1.0'?>
<!DOCTYPE service_bundle SYSTEM '/usr/share/lib/xml/dtd/service_bundle.dtd.1'>
<service_bundle type='manifest' name='export'>
  <service name='system/qemu-ga' type='service' version='0'>
    <dependency name='fs-local' grouping='require_all' restart_on='none' type='service'>
      <service_fmri value='svc:/system/filesystem/local'/>
    </dependency>
    <!-- NOTE: OmniOS has a built-in OOCE-based path to config, but can use
            exec='/usr/bin/qemu-ga -c /etc/qemu/qemu-ga.conf'
         while OpenIndiana has an older qemu-ga without "-c" option and the
         default built-in config location named above.
    -->
    <exec_method
        type='method'
        name='start'
        exec='/usr/bin/qemu-ga'
        timeout_seconds='600'>
        <method_context>
            <method_credential user='root' group='root' />
        </method_context>
    </exec_method>

    <exec_method
        type='method'
        name='stop'
        exec=':kill'
        timeout_seconds='60' />

    <property_group name='startd' type='framework'>
        <propval name='ignore_error' type='astring'
                value='core,signal' />
        <propval name='duration' type='astring'
                value='child' />
    </property_group>

    <instance name='default' enabled='true'/>

    <stability value='Evolving' />

    <template>
            <common_name>
                    <loctext xml:lang='C'>QEMU Guest Agent</loctext>
            </common_name>
    </template>
  </service>

</service_bundle>