Missing systemvm.iso

[rhpijnacker-philips]

Hi all,

My department is migrating from vSphere/ESXi to a Hyper-V environment.
I am setting up a CloudStack instance to evaluate whether that would provide benefits for us, similar to what vSphere provides.

For this I have set-up two Hyper-V hosts, connected to the same domain, Primary and Secondary SMB storage accessible by both hosts.
I installed CloudStack and created one zone/pod/cluster and added the hosts to it.
As far as I can tell, CloudStack is now trying to create the System VMs on the Hyper-V hosts, but fails to do so.

In the log file, it tells me this error:

2026-05-13 10:18:57,433 ERROR [c.c.h.h.m.HypervManagerImpl] (DirectAgent-373:[ctx-55eca309]) (logid:840b8a49) Unable to locate systemvm.iso in your setup at /usr/share/cloudstack-common/vms/systemvm.iso
2026-05-13 10:18:57,433 INFO  [c.c.h.h.m.HypervManagerImpl] (DirectAgent-373:[ctx-55eca309]) (logid:840b8a49) Copy System VM patch ISO file to secondary storage. source ISO: /usr/share/cloudstack-common/vms/systemvm.iso, destination: /var/lib/cloudstack/mnt/VM/345048874842.14d8b024/systemvm/systemvm-4.22.0.1.iso
2026-05-13 10:18:57,433 ERROR [c.c.h.h.m.HypervManagerImpl] (DirectAgent-373:[ctx-55eca309]) (logid:840b8a49) Unexpected exception java.io.FileNotFoundException: Source '/usr/share/cloudstack-common/vms/systemvm.iso' does not exist

with /var/lib/cloudstack/mnt/VM/345048874842.14d8b024 being the mounted Secondary storage.

I did already download the SystemVM templates for Hyper-V and they are available on the Secondary storage:

/var/lib/cloudstack/mnt/VM/345048874842.14d8b024/template/tmpl/1/9/0c81cae9-72f8-42dc-b9cb-c1a21d874ab1.vhd
/var/lib/cloudstack/mnt/VM/345048874842.14d8b024/template/tmpl/1/9/template.properties

However, I cannot seem to find where to download the missing iso file from.
Could someone point me to the right location, please?

[weizhouapache]

which CloudStack version ?

systemvm.iso is not used any more since some years ago.

[weizhouapache]

@rhpijnacker-philips
you can try with this command to generate the systemvm.iso

cd /usr/share/cloudstack-common/vms/
genisoimage -quiet -r -o systemvm.iso agent.zip cloud-scripts.tgz

this may not work

[rhpijnacker-philips]

ok, thanks, I'll give it a try

[rhpijnacker-philips]

I can see the System VMs being created on my Hyper-V host now, but they disappear as soon as it is created.
Trying to make sense of the logfile to see where this fails exactly.
Is there some way to make this step-by-step, so I can better see what's going on?

[weizhouapache]

the hyperv hypervisor plugin is not maintained ver well.

you can explore the hyper-v implementation below:
https://docs.cloudstack.apache.org/en/latest/adminguide/extensions/inbuilt_extensions.html#hyper-v

[rhpijnacker-philips]

Does that mean I should expect it to be broken?