mirror of https://github.com/GNS3/gns3-server.git synced 2024-12-19 12:57:56 +00:00

GNS3 server

Go to file

Julien Duponchelle ba658a4712 Merge commit '929c337e8bf33f060c884368628b279550248925' into unstable It's the bad unstable => master commit		2015-05-01 11:56:19 +02:00
docs	Fix tests and build documentation	2015-05-01 11:24:56 +02:00
gns3server	Basic VMware support (start & stop a VM).	2015-04-30 19:05:37 -06:00
init	Proper daemon support	2015-04-23 11:10:02 +02:00
scripts	Fix doc generation	2015-02-24 11:39:17 +01:00
tests	Fix tests and build documentation	2015-05-01 11:24:56 +02:00
.gitignore	Update script file	2015-01-21 16:43:34 +01:00
.travis.yml	Fix coveralls	2015-03-30 17:24:03 +02:00
AUTHORS	Initial project structure	2013-10-04 17:45:15 -06:00
CHANGELOG	Version 1.3.2	2015-04-28 21:06:04 +02:00
dev-requirements.txt	Add code coverage	2015-02-05 10:46:27 +01:00
LICENSE	Project structure & tools (pytest, tox etc.)	2013-10-08 11:33:51 -06:00
MANIFEST.in	Include tests in Pypi package	2015-04-14 14:53:01 +02:00
README.rst	Merge branch 'master' into unstable	2015-04-28 10:46:59 +02:00
requirements.txt	Aiohttp 0.15.1	2015-05-01 10:57:28 +02:00
setup.py	Aiohttp 0.15.1	2015-05-01 10:57:28 +02:00
tox.ini	Auto PEP8 cleanup	2015-02-13 14:43:28 +01:00

README.rst

GNS3-server

This is the GNS3 server repository.

The GNS3 server manages emulators such as Dynamips, VirtualBox or Qemu/KVM. Clients like the GNS3 GUI controls the server using a HTTP REST API.

You will need the GNS3 GUI (gns3-gui repository) to control the server.

Branches

master

master is the next stable release, you can test it in your day to day activities. Bug fixes or small improvements pull requests goes here.

unstable

Never use this branch for production. Major new features pull requests goes here.

Linux

GNS3 is perhaps packaged for your distribution: * Gentoo: https://packages.gentoo.org/package/net-misc/gns3-server

Linux (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.3 or above
aiohttp
setuptools
netifaces
jsonschema

The following commands will install some of these dependencies:

sudo apt-get install python3-setuptools
sudo apt-get install python3-netifaces

Finally these commands will install the server as well as the rest of the dependencies:

cd gns3-server-master
sudo python3 setup.py install
gns3server

To run tests use:

py.test -v

Run as daemon (Unix only)

You will found init sample script for various systems inside the init directory.

Usefull 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 execution

upstart

For ubuntu < 15.04

You need to copy init/gns3.conf.upstart to /etc/init/gns3.conf

sudo chown root /etc/init/gns3.conf
sudo service gns3 start

Windows

Please use our all-in-one installer.

If you install it via source you need to install also: https://sourceforge.net/projects/pywin32/

Mac OS X

Please 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 this instructions with virtualenwrapper: http://virtualenvwrapper.readthedocs.org/ and homebrew: http://brew.sh/.

brew install python3
mkvirtualenv gns3-server --python=/usr/local/bin/python3.4
python3 setup.py install
gns3server