Willkommen zur GNSave Dokumentation!

GNSave ist eine Django App die den Netzwerktechnik Unterricht mit GNS3 erleichtern soll.

Mithilfe der GNS3 REST-API (https://gns3-server.readthedocs.io/en/latest/) und Telnet ermöglicht GNSave die Remote-Administration von mehreren GNS3 VMs von einem zentralen Ort.

Außerdem bietet GNSave einen Weg für Schüler ihre GNS3 Projekte zu speichern und bietet außerdem die Möglichkeit nach einer Neuaufsetzung der PCs immernoch an den Projekten weiterarbeiten zu können.

Für mehr Informationen und Hilfe bei der Installation siehe Sektion Installation

Für eine Überblick über das Projekt siehe Sektion Overview

Note

Das Repository ist nicht frei zugänglich. Wenn du keinen Zugriff auf das Repository hast, melde dich bitte bei einem deiner Professoren.

Inhalte

• Installation
  • Nur Django
  • Dockerisiertes Django mit Apache2
  • Testung der Installation
  • Mögliche Fehler
    • Error processing tar file no space left on device
• Overview
  • Die Infrastruktur
  • Wichtige Faktoren damit GNSave funktionert
  • Wo findet man welche Dateien
    • GNS3-API
    • HTML Files
    • User-Files
    • Django-Logik
    • JS, CSS, Bilder, Fonts
• Build Topology
  • Überblick
  • Überblick der Features
    • Overview Ansicht
    • Virtual Host Ansicht
    • Add Project Ansicht
    • Add Virtual Host Ansicht
    • Project Ansicht
    • Create Device Ansicht
    • Configure Devices Ansicht
    • Clone Project Ansicht
    • Choose Project Ansicht
    • Choose VMs Ansicht
  • Aufbau
  • Verwendete Funktionen (views.py)
    • virtualmachines
    • projects
    • reload
    • devices
    • config
    • push_config_to_devices
    • choose_vm_to_clone_from
    • choose_project_to_clone
    • select_what_vms_to_clone_to
    • clone_project
    • add_vm
    • add_project
    • add_device
    • edit
  • Verwendete Funktionen (virtual_machine.py)
    • VirtualMachine Class
    • init_projects
    • create_project
    • get_vm_ip
    • get_vm_port
    • get_status
    • get_projects
    • download_project_from_vm
    • upload_project_to_vm
    • clone_project
  • Verwendete Funktionen (project.py)
    • Project Class
    • create_project
    • init_devices
    • create_device
    • link_device
    • add_compute
    • write_config
    • start_device
    • stop_device
    • open
    • close
    • get_devices
    • get_project
  • Verwendete Funktionen (device.py)
    • Device Class
    • start_device
    • stop_device
    • create_device
    • create_device_quemu
    • write_config
• Userverwaltung
  • Überblick
  • Überblick der Features
  • Usertypen
    • Lehrer
    • Schüler
  • User erstellen
    • Manuell
    • Mit einer File
  • User bearbeiten
  • Gruppe erstellen
  • Ablauf
    • User erstellen
    • User löschen
    • Passwort eines Users ändern
    • Gruppe erstellen
  • Verwendete Funktionen
    • add_user
    • change_password
    • delete_user
    • add_group
    • add_user_to_group
• Fileserver
  • Überblick
  • Überblick der Features
  • Filesystem
  • Aufbau
  • Ablauf
    • Fileupload
    • Filedownload
  • Verwendete Funktionen
    • add_user
    • add_group
    • add_user_to_group
    • delete_user

Kompatibilität

Die Installation funktioniert auf jedem Python3 oder Docker fähigen Betriebssystem. GNSave benutzt Python in der Version 3.8 und Django in der Version 3.0.