GNS3 server
Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.
 
 
 
 
Přejít na soubor
Jeremy Grossmann 5bab4131e1
Merge pull request #2361 from GNS3/release/v2.2.46
před 1 měsícem
.github/workflows Do not test with Python 3.6 před 2 měsíci
conf Allow disabling hardware virtualization check před 5 měsíci
docs Fix issues when generating docs před 3 měsíci
gns3server Release v2.2.46 před 1 měsícem
init Update gns3.service.systemd před 2 roky
scripts Fixed updating system and GNS3. před 5 měsíci
tests Merge branch '2.2' into bugfix/3555 před 1 měsícem
.coveragerc Fix coveralls configuration před 9 roky
.gitattributes Keep the version.py untouched when merging před 8 roky
.gitignore Added workaround for #1690. Added venv/ to .gitignore před 4 roky
.whitesource Fix syntax error in .whitesource před 1 rokem
AUTHORS Adjust AUTHORS. před 9 roky
CHANGELOG Release v2.2.46 před 1 měsícem
CONTRIBUTING.md Merge branch 'master' into 1.5 před 8 roky
Dockerfile chore : use --no-cache-dir flag to pip in dockerfiles to save space před 3 roky
LICENSE Project structure & tools (pytest, tox etc.) před 11 roky
MANIFEST.in Convert README to Markdown před 1 rokem
README.md Update README.md před 6 měsíci
SECURITY.md Update SECURITY.md před 1 rokem
appveyor.yml Use Python 3.8 in appveyor.yml před 2 měsíci
dev-requirements.txt Upgrade dependencies před 1 rokem
gns3server.bat Made the gns3server.bat successfully start the server independent of the CWD at the time of running. It's now relative to the location of the .bat file itself. před 8 roky
mac-requirements.txt Move jsonschema 2.6.0 requirement in build repository. před 4 roky
pytest.ini Remove pytest.ini from tests dir před 2 roky
readthedocs.yml Update readthedocs.yml to use Python 3.12 před 2 měsíci
requirements.txt Upgrade dependencies před 2 měsíci
setup.py Backport from v3: install Docker resources in a writable location at runtime. před 1 měsícem
win-requirements.txt Upgrade to PyQt 5.15.9 and pywin32 před 8 měsíci

README.md

GNS3-server

image

image

image

This is the GNS3 server repository.

The GNS3 server manages emulators such as Dynamips, VirtualBox or Qemu/KVM. Clients like the GNS3 GUI and the GNS3 Web UI control the server using an HTTP REST API.

Software dependencies

In addition of Python dependencies listed in a section below, other software may be required, recommended or optional.

  • uBridge is required, it interconnects the nodes.
  • Dynamips is required for running IOS routers (using real IOS images) as well as the internal switches and hubs.
  • VPCS is 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 support

Docker 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).

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 go here.

2.x (2.3 for example)

Next major release

Never use this branch for production. Pull requests for major new features go here.

Linux

GNS3 is perhaps packaged for your distribution:

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.6, setuptools and the ones listed here

The following commands will install some of these dependencies:

sudo apt-get install python3-setuptools python3-pip

Finally, 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 .
gns3server

To run tests use:

python3 -m pytest tests

Docker container

For development, you can run the GNS3 server in a container

bash scripts/docker_dev_server.sh

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

All init scripts require the creation of a GNS3 user. You can change it to another user.

sudo adduser gns3

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

systemd

You need to copy init/gns3.service.systemd to /lib/systemd/system/gns3.service

sudo chown root /lib/systemd/system/gns3.service
sudo systemctl start gns3

Windows

Please use our all-in-one installer to install the stable build.

If you install via source you need to first install:

Then you can call

python setup.py install

to install the remaining dependencies.

To run the tests, you also need to call

pip install pytest pytest-capturelog

before actually running the tests with

python setup.py test

or with

py.test -v

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 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
gns3server

SSL

If you want enable SSL support on GNS3 you can generate a self signed certificate:

bash gns3server/cert_utils/create_cert.sh

This command will put the files in ~/.config/GNS3/ssl

After 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 --ssl

Or 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=True

Running tests

Just run:

py.test -vv

If you want test coverage:

py.test --cov-report term-missing --cov=gns3server

Security issues

Please contact us using contact form available here: http://docs.gns3.com/1ON9JBXSeR7Nt2-Qum2o3ZX0GU86BZwlmNSUgvmqNWGY/index.html