Skip to content

Importing from EVE-NG / UNetLab / PNETLab

This section walks an operator through migrating an existing EVE-NG (or UNetLab / PNETLab) host's images and templates to a fresh nova-ve install.

The end state: every supported addon directory under /opt/unetlab/addons/... is materialised under /var/lib/nova-ve/images/<kind>/<key>/, every priority-vendor template is converted to a nova-ve template under /var/lib/nova-ve/templates/, and the operator can instantiate nodes from each migrated template through the nova-ve UI.

Use the one-shot shell wrapper for normal migrations:

cd "${NOVA_VE_REPO_DIR:-/var/lib/nova-ve/nova-ve-git}"
./deploy/scripts/import-eveng-templates.sh --dry-run
sudo ./deploy/scripts/import-eveng-templates.sh

The wrapper sources the installed nova-ve environment, finds the backend virtual environment, moves addon assets into /var/lib/nova-ve/images (symlinking the original EVE-NG paths back at the moved files), writes generated templates under /var/lib/nova-ve/templates, records /var/lib/nova-ve/import-manifest.json, and appends a step-by-step run log to /var/log/eve-ng-importer.log. The Python module (backend/scripts/import_eveng) is the implementation detail behind that wrapper.

Pages in this section

  • Overview — one-shot wrapper usage, prerequisites, and run order (--dry-run → real → optional --copy-only / --delete-source).
  • Importing images — per-kind source → destination mapping for qemu / dynamips / iol / docker, plus boot-disk precedence and verification recipes.
  • Vendor coverage — which vendor adapters can emit a nova-ve template natively.
  • Reading the manifest — the manifest JSON shape, handling needs-manual-review, and rollback.

Fast and data-safe by default

Running import-eveng-templates.sh with no flags moves each image file under /opt/unetlab/addons/... into /var/lib/nova-ve/images and symlinks the original path back at the moved file. No bytes are deleted or duplicated and EVE-NG keeps working; pass --copy-only for the conservative copy + sha256-verify behaviour, or --delete-source / the unsafe --move when you really want the source files gone.