https://github.com/redbrick/netsoc

Virtualised networking society
https://github.com/redbrick/netsoc

Last synced: over 1 year ago
JSON representation

Virtualised networking society

• Host: GitHub
• URL: https://github.com/redbrick/netsoc
• Owner: redbrick
• Created: 2013-10-02T21:43:08.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2016-07-18T22:05:55.000Z (about 10 years ago)
• Last Synced: 2025-02-02T12:16:23.217Z (over 1 year ago)
• Language: Shell
• Size: 329 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
Netsoc [![Build Status](https://travis-ci.org/redbrick/netsoc.svg?branch=master)](https://travis-ci.org/redbrick/netsoc)

================================

About

-------------------------

> While you're waiting, read the free novel we sent you. It's a Spanish story about a 

> guy named 'Manual'. - Dilbert

This document details the process for running an entire networking society's infrastructure in a virtualised fashion.

The assumed distribution for running the virtual machines is Ubuntu LTS. The setup has been shown to run on both Windows and Linux distributions.

Prerequisites

-------------------------

Download and install the latest version of:

 * [VirtualBox](https://www.virtualbox.org/wiki/Downloads)

 * [Vagrant](http://www.vagrantup.com/downloads.html)

Installation

-------------------------

Download the repository by running `git clone https://github.com/redbrick/netsoc`.

Running

-------------------------

From the VM host, navigate to the repository and issue the command `vagrant up`. This will launch a number of VMs and begin to configure them.

Log into the management server using `vagrant ssh mgmt`.

## Networking

Networking is divided into two seperate networks, a private and a public network.

The private network is a host-only network with an addressing of `10.10.1.0/24`. This allows machines to communicate which each other privately.

The public network is a host-only network with an addressing of `10.20.1.0/24`. This is assumed to be the Internet facing side of the infrastructure even though it is not publicly addressable.

## Configuration Management

Currently netsoc is using Ansible. However depending on the use-cases and its effectiveness this may be subject to change.

Ansible is installed onto the `mgmt` server from where the VMs can be configured. To log into the management server run `vagrant ssh mgmt`.

### Installation

Ansible is installed in `/opt/ansible` using virtualenv and pip. The Ubuntu version is not used as it is out of date and is lacking several security related patches. netsoc installs Ansible scripts in `/usr/local/sbin/` so that they are accessible to the system without needing to use virtualenv manually.

### Configuration

`/etc/ansible/hosts` contains the hosts that Ansible will manage.

### Running

`ansible --list-hosts all` will display all the hosts.

To Test if the host is reachable with Ansible use `ansible all -m ping --ask-pass`.