Skip to content

Operations

Updated

Anything that takes longer than a request is recorded as an operation: moving a machine between hosts, capturing and restoring a snapshot, publishing or importing an image, building a Windows image from an ISO, building a pool, exporting a backup, updating the guest agent on many machines (the per-machine results are listed in the operation; see Virtainer Guest Agent (VGA)). Operations under System is where they all appear, so you do not have to find each one on the page of the thing you changed.

An operation is a durable record, not a progress bar. It survives a reload of the console and a restart of Virtainer Free, which is the only reason a change that takes twenty minutes can be left running while you do something else.

Each row carries the operation’s type, what it was done to, its current state, and the step it is on. The chips above the list filter by state (All, In progress, Uncertain, Failed, Succeeded), and the dropdown beside them filters by area (Instances, Images, Storage, Networks). Live keeps the list updating while it is on. Live refresh keeps expanded rows open.

Open a row for the full record: the type, the target, the step, and when it was created, started and finished. While something is running the timing reads Running for; once it ends it reads Took. The raw message the host produced is on the detail page too, which is the text to paste when you ask for help.

State What it means
In progress The host is working on it, and the step it names is where it is
Succeeded The host completed it and confirmed the result
Failed It stopped, and the record carries the reason. A failure is an answer, not a loose end
Cancelled It was stopped before finishing
Uncertain The host cannot say which of the above is true

Build Windows image (windows_image_build) is the operation that Images → Build Windows image starts. It sits in the Images area and runs unattended on the host, so it can take a long time. Its detail page has more than the common record:

  • A Build panel lists the stages (Prepare media, Install Windows, Wait for VGA, Prepare Windows, Seal with sysprep, Convert disk, Verify image, Publish image) with a percentage on the current one. A stage that stopped the build is marked Failed here, or Cancelled here.
  • A capture of the build VM’s screen, Current screen of the build VM, which becomes Last captured screen of the build VM once the build has ended. It reads No screen captured yet until the VM has started.
  • The tail of the build log, and on a failed build Download diagnostics and Retry.

It can be cancelled with Cancel until the image is being published, and a build interrupted by a restart of Virtainer Free is marked failed rather than uncertain. The steps, the failures you may meet and what to do about each are in Windows guests.

An operation that is still running can be cancelled with Cancel on its row. Some kinds cannot be once the host has accepted them, and for those the button is simply absent: restoring or deleting a snapshot, reinstalling a machine, importing a machine, restoring a machine from a backup, removing a network, and updating the guest agent. Cancellation means the host stops driving it forward; it does not promise that a partially applied change rolls itself back. For anything that writes to disks, check the state of the machine or pool afterwards rather than assuming the world is as it was before you started.

The alternative is a console that reports progress in a dialog on the page you happened to be on, and loses the answer when you navigate away. Because every long action lands here instead, you can start something, close the tab, and come back to find out what happened, including after a host reboot that would otherwise have destroyed the only record of the attempt.

Snapshots, machine transfer, backup and image publishing each have their own page describing what they do. This page is where you find out whether the one you started finished.