Why a new VM?

But I will lose my projects!

How much time is required for the upgrade

How to upgrade

Step 1 Download the GNS3 VM

Step 2 Launch the wizard

Step 3 Follow the wizard

Last updated
March 13, 2017

Contributors

Julien Duponchelle
Edit this Article
Last updated
March 13, 2017

Contributors

Julien Duponchelle
Edit this Article

Move from IOUVM to GNS3 VM

Starting with 1.4 a new VM replace the IOUVM.

NOTEThis conversion tool is available only for GNS3 1.X you can’t use it in 2.0 and later. If you want to convert an 1.3 installation with IOUVM to 2.0 you need to use the 1.5 before or configure the new VM from scratch

Why a new VM?

The original VM was a hack made by the community and after maintain by the GNS3 team. But this vm has several issues:

  • OS stripped without way to properly reinstall missing part
  • No script allowing to rebuild the VM from scratch
  • Blocked on a specific Debian version with old packages
  • Old Python version 3.3 with annoying bugs in the GNS3 context
  • Support only IOU
  • Upgrade path is painful
  • Only VirtualBox was supported

The new GNS3 VM is:

  • One click upgrade
  • Support IOU, dynamips, qemu and futures solutions (docker for example)
  • Easy to build a new VM for everyone
  • Easier to use
  • Correctly support Virtualbox and VMWare
  • Nat and Host only interface support

You have no easy way for using GNS3 1.4 in the IOUVM. The easier solution is to move to the new VM. Trying to get GNS3 1.4 running on the IOUVM will probably require you days of work for fixing the broken OS dependencies.

But I will lose my projects!

No we provide tools for upgrading. We recommend to backup your .gns3 before the upgrade.


How much time is required for the upgrade

No more than 5 minutes.

How to upgrade

Step 1 Download the GNS3 VM

Go to http://www.gns3.com and download the last VM for VirtualBox or VMware.

Step 2 Launch the wizard

Launch GNS3 and in the tools menu launch IOU VM Converter


Step 3 Follow the wizard

After cliking on the IOUVM converter button you will see a wizard helping you to move from the IOUVM to the GNS3 VM. Just follow the instructions on screen carefully.