Before upgrading

F.A.Q

When can I expect the final release of version 2.1?

Will a new 1.5.x version be released?

Will a new 2.0.x version be released?

Will my projects made with 1.5.x be compatible with 2.1?

I have a certification exam next week, should I upgrade?

What is not included with 2.1?

New features

Appliance templates are available inside the application

Zoom percentage in the status bar

Allow up to 275 adapters for qemu

Drawing lines

Display errors as an overlay

Display an error count at the bottom of the screen

Base configuration are stored on the server

%n is replaced by node uuid in the telnet console parameters

NAT node can use the VMware NAT adapter

Upgrade aiohttp to 2.0

Spice support for qemu

VPCS replaced by a builtin version

Deprecated features

HTTPS is no longer supported

Ubuntu trusty no longer supported for the GUI

Minimum Qt version is now 5.5 on Linux

Last updated
June 26, 2017

Contributors
Dominik Ziajka
Julien Duponchelle
Edit this Article
Last updated
June 26, 2017

Contributors
Dominik Ziajka
Julien Duponchelle
Edit this Article

What’s new in GNS3 version 2.1

Version 2.1 is a new feature release of GNS3. This version continues the work of 2.0 to improve the experience when using a central GNS3 server and for controlling GNS3 via the API.

Before upgrading

No rollback is possible. Backup all your projects, settings and you need to snapshot the GNS3 VM. Version 2.1 is in alpha stage which means many things could be broken or not work as expected.

If you still have projects created with 0.8.x open them with a 1.X version of GNS3 before switching to 2.1. No direct conversion from 0.8 to 2.1 will be supported.

F.A.Q

When can I expect the final release of version 2.1?

No date for the moment

Will a new 1.5.x version be released?

Current 1.5 is stable and have no blocking bug, we will not release a new version to avoid breaking something.

Will a new 2.0.x version be released?

During the 2.1 alpha/beta cycle, we will eventually release a new 2.0 to fix bug.

Will my projects made with 1.5.x be compatible with 2.1?

Yes excepting unexpected bugs.

I have a certification exam next week, should I upgrade?

NO! Upgrade only if you are not in the middle of something important. We put a huge effort to make sure to test each release but due to the nature of GNS3 we cannot possibly test all the scenarios, environments, images, etc.  

What is not included with 2.1?

No web app is provided with version 2.1. We have experimental application on Github but it is only to validate our architecture.

New features

Appliance templates are available inside the application

You can search appliance template from the application. The first time you will need it, the wizard will ask you for the required images.

Zoom percentage in the status bar

When you zoom you now see the zoom level in the status bar

Allow up to 275 adapters for qemu

Until now you were limited to 32 adapters for qemu (or less depending of the PCI devices connected). The limit is now 275 the maximum that Qemu could support. This require Qemu 2.4 or later.

Drawing lines

A drawing line tool is now available. You can style them like rectangle and circles.

Display errors as an overlay

Error will be displayed in a floating popup. This allows you to close the console without losing errors.

Display an error count at the bottom of the screen

At the bottom of the screen you can see the number of errors reported by GNS3 and if you click on it the GNS3 console will open.

Base configuration are stored on the server

This change impact user with a central GNS3 server. In version prior to 2.1 the base configuration for VPCS, IOU and Dynamips was sent by the GNS3 client. This mean a node created by two different client could have a different base configuration. Now the configuration on the central server is use for all nodes.

%n is replaced by node uuid in the telnet console parameters

If you pass %n as a parameter of the telnet console it will replaced by the node UUID. This allow you to use it for scripting.

NAT node can use the VMware NAT adapter

If you have VMware installed on Windows and Mac the NAT can use the VMware vmnet adapter instead of the libvirt nat of the GNS3 VM. This allow you to connect a Dynamips topology to the internet without the need of booting the GNS3 VM.

Upgrade aiohttp to 2.0

aiohttp is the library use for running the HTTP API of GNS3. This upgrade was required in order to support bleeding edge distribution like Alpine or Arch.

Spice support for qemu

Spice provides an access to displays and devices. In combination with QXL (paravirtualized framebuffer) can improve graphics experience in the guest.

VPCS replaced by a builtin version

Now VPCS is a part of the GNS3 server, rewrote in pure python it’s lighter (no more external process) and easier to extend. This solve old issues like invalid checksum in TCP frames.

Deprecated features

Deprecated features should not impact you, these are rarely used features which are usually not documented.

HTTPS is no longer supported

You can no longer connect to a GNS3 server using HTTPS. Support in version 2.1 was buggy.

We recommend to setup a VPN instead because he will protect the connection to the GNS3 server and to the server consoles.

Ubuntu trusty no longer supported for the GUI

We no longer provide package for Ubuntu trusty. The last supported release is the current ubuntu LTS: Xenial. The main reason is the Qt version provided by Trusty is old and contain bug especially for HDPI screens.

Minimum Qt version is now 5.5 on Linux

With the drop of Ubuntu Trusty support we ask now for Qt 5.5 and later for Linux. This allow the GNS3 team to use new Qt module like websockets which mean benefits for all users.