Package: gns3-server
GNS3-serverThis is the GNS3 server repository.The GNS3 server manages emulators such as Dynamips, VirtualBox or
Qemu/KVM. Clients like theGNS3 GUIand theGNS3 Web UIcontrol the
server using an HTTP REST API.Software dependenciesIn addition of Python dependencies listed in a section below, other
software may be required, recommended or optional.uBridgeis required, it
interconnects the nodes.Dynamipsis required for
running IOS routers (using real IOS images) as well as the internal
switches and hubs.VPCSis recommended, it is a
builtin node simulating a very simple computer to perform
connectitivy tests using ping, traceroute etc.Qemu is strongly recommended on Linux, as most node types are based
on Qemu, for example Cisco IOSv and Arista vEOS.libvirt is recommended (Linux only), as it's needed for the NAT
cloud.Docker is optional (Linux only), some nodes are based on Docker.mtools is recommended to support data transfer to/from QEMU VMs
using virtual disks.i386-libraries of libc and libcrypto are optional (Linux only), they
are only needed to run IOU based nodes.Docker supportDocker support needs the script program (bsdutils or
util-linux package), when running a docker VM and a static
busybox during installation (python3 setup.py install / pip3 install /
package creation).Branchesmastermaster is the next stable release, you can test it in your day to day
activities. Bug fixes or small improvements pull requests go here.2.x (2.3 for example)Next major releaseNeveruse this branch for production. Pull requests for major new
features go here.LinuxGNS3 is perhaps packaged for your distribution:Gentoo:https://packages.gentoo.org/package/net-misc/gns3-serverAlpine:https://pkgs.alpinelinux.org/package/v3.10/community/x86_64/gns3-serverNixOS:https://search.nixos.org/packages?channel=unstable&from=0&size=50&sort=relevance&type=packages&query=gns3-serverLinux (Debian based)The following instructions have been tested with Ubuntu and Mint. You
must be connected to the Internet in order to install the dependencies.Dependencies:Python 3.6, setuptools and the ones listedhereThe following commands will install some of these dependencies:sudo apt-get install python3-setuptools python3-pipFinally, these commands will install the server as well as the rest of
the dependencies:cd gns3-server-master
python3 -m pip install -r requirements.txt
python3 -m pip install .
gns3serverTo run tests use:python3 -m pytest testsDocker containerFor development, you can run the GNS3 server in a containerbash scripts/docker_dev_server.shRun as daemon (Unix only)You will find init sample scripts for various systems inside the init
directory.Useful options:--daemon: start process as a daemon--log logfile: store output in a logfile--pid pidfile: store the pid of the running process in a file and
prevent double executionAll init scripts require the creation of a GNS3 user. You can change it
to another user.sudo adduser gns3upstartFor ubuntu < 15.04You need to copy init/gns3.conf.upstart to /etc/init/gns3.confsudo chown root /etc/init/gns3.conf
sudo service gns3 startsystemdYou need to copy init/gns3.service.systemd to
/lib/systemd/system/gns3.servicesudo chown root /lib/systemd/system/gns3.service
sudo systemctl start gns3WindowsPlease use ourall-in-one
installerto install the
stable build.If you install via source you need to first install:Python (3.3 or above) -https://www.python.org/downloads/windows/Pywin32 -https://sourceforge.net/projects/pywin32/Then you can callpython setup.py installto install the remaining dependencies.To run the tests, you also need to callpip install pytest pytest-capturelogbefore actually running the tests withpython setup.py testor withpy.test -vMac OS XPlease use our DMG package for a simple installation.If you want to test the current git version or contribute to the
project, you can follow these instructions with virtualenvwrapper:http://virtualenvwrapper.readthedocs.org/and homebrew:http://brew.sh/.brew install python3
mkvirtualenv gns3-server --python=/usr/local/bin/python3.5
python3 setup.py install
gns3serverSSLIf you want enable SSL support on GNS3 you can generate a self signed
certificate:bash gns3server/cert_utils/create_cert.shThis command will put the files in ~/.config/GNS3/sslAfter you can start the server in SSL mode with:python gns3server/main.py --certfile ~/.config/GNS3/ssl/server.cert --certkey ~/.config/GNS3/ssl/server.key --sslOr in your gns3_server.conf by adding in the Server section:[Server]
certfile=/Users/noplay/.config/GNS3/ssl/server.cert
certkey=/Users/noplay/.config/GNS3/ssl/server.key
ssl=TrueRunning testsJust run:py.test -vvIf you want test coverage:py.test --cov-report term-missing --cov=gns3serverSecurity issuesPlease contact us using contact form available here:http://docs.gns3.com/1ON9JBXSeR7Nt2-Qum2o3ZX0GU86BZwlmNSUgvmqNWGY/index.html