CSE4939W/CSE4940 Senior Design Project Group 22

Group 22 in 2020-2021 CSE SDP is assigned to make a simulator and visualization of DDoS Filtering.

Installing flask:

There are two options to get started on Windows.

Option 1: Get Started for Flask on Windows with Python for Windows. (Recommended!)

The essential thing to get started is to install Python and then to install flask. Due to the versioning issues of Python, please make sure you are installing the correct version. We recommend installing Python via the official website: https://www.python.org/downloads/
As an additional note, Windows 7 is no longer supported in 3.9.x version of Python. Please download the 3.8.9 version in case you are using Windows 7.

Follow these steps to get started:

1. Install the latest version of Python and make sure you selected to add Python to PATH environment variable.
2. Execute the following command to install flask:

pip install flask
pip install matplotlib

3. Execute the following commands to run flask:

set FLASK_APP=pserver
set FLASK_ENV=development
python -m flask run

Alternatively, you may double-click run_server.bat file in lieu of manually typing these commands.

4. In certain circumstances, your system might be configuring the *.js files with incorrect treatings. Locate registry key HKEY_CLASSES_ROOT\.js and edit the key value Content Type to be text/javascript.
   Please note that you are all set if key value Content Type does not exist in HKEY_CLASSES_ROOT\.js key at all: just leave the registry as is. Usually, things are problematic if the value of Content Type equals to text/plain.

Option 2: Get Started on Windows with WSL

NOTE: Make sure to only install WSL1, not WSL2 so follow step 1 and then skip to step 6. So the only steps you need to follow are 1 and 6.
IMPORTANT: On the windows store, make sure you install Ubuntu 18.04 LTS.

Link: https://docs.microsoft.com/en-us/windows/wsl/install-win10

Setting up venv (virtual environment) NOTE: Don't place your env within the git repo

Link: https://www.digitalocean.com/community/tutorials/how-to-install-python-3-and-set-up-a-local-programming-environment-on-ubuntu-18-04

Link: https://www.digitalocean.com/community/tutorials/how-to-make-a-web-application-using-flask-in-python-3

1. You only need to follow step 1 to install flask.
2. Copy and paste and then run the below two commands. You have to do this everytime you open up a new terminal:

export FLASK_APP=pserver
export FLASK_ENV=development
flask run

Alternatively, you may execute the run_server.sh file in lieu of manually typing these commands.

Output Files

For each simulation session, the backend would generate a summary file, a log file and several statistical graphs. Their locations are specified by your input on frontend.

License

This project is under NCSA License. For more information, view the license.