Packet Tracer instance management

Web application which handles local PacketTracer instances using Docker.

Prerequisites

This application currently uses psutil. As a side effect, you need to consider its installation requirements (which change from one system to another).

Installation

Why would you want to install it?

pip install git+https://github.com/PTAnywhere/pt-instances-management.git

Requirements

The required packages are automatically installed in the procedure described above.

However, if you are going to contribute to this project, you might want to install only the project's dependencies in your virtualenv.

You can install them using the requirements.txt file in the following way:

pip install -r requirements.txt

Usage

Before running the web application for the first time, follow these steps:

1. Customize config.ini if needed.

2. Create the database and populate it with the available ports. Generally you should only do this once.

   cd src/ptinstancemanager; python run.py -createdb

Then, simply run the web server:

cd src/ptinstancemanager; python run.py

The API will be then available in the port 5000. If you go to the root of the application, you will be automatically redirected to a user friendly description of the API.

Advanced usage

For a production ready installation using which uses Nginx, Gunicorn and Supervisor, check this project.

Acknowledgements

This API is being developed as part of the FORGE project.