Skip to content

BlastarIndia/SAM

This branch is 935 commits behind riolet/SAM:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

782d9ae · Aug 11, 2016
Aug 10, 2016
Aug 9, 2016
Aug 11, 2016
Aug 10, 2016
Jul 6, 2016
Jul 20, 2016
Jul 5, 2016
Aug 8, 2016
Aug 4, 2016
Aug 10, 2016
Jul 13, 2016
Jul 29, 2016
Jul 18, 2016
Aug 5, 2016
Jul 28, 2016
Jul 13, 2016
Aug 10, 2016
Aug 8, 2016

Repository files navigation

SAM - System Architecture Mapper

SAM is a tool designed to map a network based on the data log of a router. It runs as a local python-based server and displays the a map and statistics on the browser.

Check out the website for details about the project and a demo!

Prerequisites

MySQL - SAM will support other databases in the future:

apt-get install mysql-server
apt-get install libmysqlclient-dev

Python - python-dev is needed to build the MySQLdb package

apt-get install python
apt-get install python-dev

Pip - for installing python packages

apt-get install python-pip

nfdump - optional, for importing Cisco binary NetFlow dumps

apt-get install nfdump

Installation

  1. Clone the repository
  2. Run pip install -r requirements.txt from within the directory to install necessary packages.
  3. Duplicate dbconfig.py as dbconfig_local.py and fill out database credentials

Usage

  1. Import log files into database by any combination of the following methods:

    1. Palo Alto logs: import_paloalto.py <file>. The paloalto syslog format is expected.
    2. nfdumps: import_nfdump.py <file> Binary files from nfcapd are expected. nfdump must be installed.

    Import from all files before going to step 2

  2. Run the preprocessing script python preprocess.py to analyze and organize the data

  3. Start the server locally by running: python server.py

  4. Navigate your browser to localhost:8080 and use your mouse to explore the network map

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 49.4%
  • CSS 47.5%
  • Python 2.7%
  • HTML 0.4%