Skip to content
VEX-NXDocs

Images

Import images

Add a vendor disk to the Library and bind it to a template so QEMU nodes can Start.

Import and Prepare
Import and Prepare

Goal

Add a vendor disk to the Library and bind it to a template so QEMU nodes can Start.

Why Import exists

Catalog templates are blueprints. Without a disk file in Library, commercial appliances have nothing to boot. Import is how your licensed files become usable on this appliance.

Three paths on Images -> Import

PathWhy use itExample
Convert & addOVA / VMDK / qcow2 / ISO with progressDrop a vendor OVA, pick template, convert
Upload ready diskAlready hda.qcow2 / virtio - no convertFast path if you prepared elsewhere
Bulk importSCP many folders to staging, scan, import/convert what fitsLab full of appliance folders

Recipe: Convert & add (GUI upload)

  1. Images -> Import
  2. Use Convert & add
  3. Upload the disk (keep the browser tab open for large files)
  4. Choose the matching template
  5. Confirm conversion / copy into Library
  6. Start a node and select the new disk when asked

Recipe: Upload ready disk

  1. Images -> Import -> Upload ready disk
  2. Select the template (required so files map to the right product)
  3. Choose hda.qcow2 / virtioa.qcow2 (and extras the form asks for)
  4. Upload

Arista vEOS needs cdrom.iso (Aboot) as well as hda.qcow2 - pick both, or use Convert & add / Bulk.

Recipe: Bulk / folder import

  1. Stage files under the appliance staging path (SSH as vexnx), or follow Bulk folder import
  2. Scan -> confirm template match
  3. Confirm import into Library (or Convert selected when prepare is needed)

Expected result

  • Disk appears in Library under the template
  • Compatibility still shows the template status (Certified / Verified / Experimental) - importing a disk does not change that chip

If it fails

SymptomFix
Bad Gateway / timeoutFree disk; smaller chunks; stay on the page
Permission denied on stagingSSH as vexnx; staging dirs mode 0777; restart API if needed
Wrong templateRe-import with correct ID (Supported images)
Disk full during convertFree Library space or grow the appliance disk