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.