Migrate Lab

#Goal

Upload a ZIP that contains a .unl topology file (and optional startup configs) from another lab platform, then create a VEX-NX lab.

#Why Migrate Lab exists

Many people already built labs elsewhere. Migrate saves redrawing every link. It is the bridge from "old tool export" to "VEX-NX lab".

Why disks are separate: UNL ZIPs usually describe what is connected, not multi-GB vendor images. You import images once under Images -> Import, then map them during the Migrate preview.

#Wrong button?

#GUI tutorial

#Step 1 - Open Migrate Lab

1. Labs -> Migrate Lab
2. Confirm the upload / preview UI

#Step 2 - Preview and map templates

1. Choose the .unl bundle ZIP
2. Click Preview import
3. Fix Checks (errors block create)
4. Map each node to a template and image
5. Create lab then open Design mode

#Prepare your bundle

1. Save or export your lab as a .unl topology file
2. Optional: add startups under configs/ (example: configs/R1.txt)
3. Import appliance disks via Images -> Import (the ZIP does not include disk images)
4. Zip the files and keep the ZIP ready

#Recipe: five-router UNL study lab

1. Labs -> Migrate Lab
2. Lab name: ccnp-ospf-study
3. Choose the bundle ZIP
4. Optional: enable Remap interface names in startup configs to match VEX-NX templates
5. Preview import
6. Read Checks - errors block create; warnings are advisory
7. For each node: pick template and image (or "No image - pick later")
8. Review links -> Create lab

#Expected result

• Same node names and links as the UNL (as far as the importer could map them)
• Configs attached when remap worked
• Lab opens in Design for final cleanup

#If it fails

• Errors in Checks -> fix template/image choices or missing mappings, then preview again
• Start fails later with missing disk -> finish Images Import and bind Library images
• Preview rejects the ZIP -> confirm a .unl is inside; otherwise try Import Lab or Generate Lab

#Related

• Import images
• Bulk folder import
• Design mode