EduNetworkBuilder/README.md

EduNetworkBuilder is a simple program for teaching network principles. It was inspired by watching a number of people struggling with PacketTracer in an attempt to undestand IP addresses, subnets, and gateways. Most of their struggles were with understanding how to configure an IP on each device; they never got around to learning about how the subnets worked.

EduNetworkBuilder is geared to take all the complexity away, and let you visualize the network and packet flow in a very simple way. It has proven itself already, as a great tool for teaching in lab-settings in Africa.

It is also set up to be a tool for self-teaching; If you can solve all the built-in puzzles, you should be well on your way to mastering networking.

EduNetworkBuilder is a Visual Studio program. You should be able to download the current free edition of Visual Studio, open the project file, and make the project. You should also be able to download pre-compiled versions from: http://tyounglightsys.ddns.info/EduNetworkBuilder

*** Building on Linux with Mono and XBuild ***

This should be the simplest way to install EduNetworkBuilder on Linux. You will need to install git, Mono and XBuild.

On Mint or ubuntu, you can do this by running:

$ sudo apt-get install mono-complete mono-xbuild git

For Ubuntu 18.04 also install libmono-microsoft-visualbasic10.0-cil

On Centos, you need the epel repository

yum install epel-release

yum install mono-complete mono-devel

yum install git

After this, you should be ready to download and compile. Determine where you want to build your source, cd to that directory, and run:

$ git clone https://git.solidcharity.com/timy/EduNetworkBuilder $ cd EduNetworkBuilder $ xbuild

After this, you should see a lot of build messages. In the end, you should be able to find the executable at: EduNetworkBuilder/bin/Debug/EduNetworkBuilder.exe Copy this file wherever you want. For example:

$ sudo cp EduNetworkBuilder/bin/Debug/EduNetworkBuilder.exe /usr/local/bin/

And then you can run it by simply typing:

$ EduNetworkBuilder.exe

*** Building on Linux With MonoDevelop ***

EduNetworkBuilder should compile on Linux using MonoDevelop with one small change to the code. EduNetworkBuilder on Windows uses the Microsoft deployment mechanism, which cannot build on Linux. To make it work, we need to change a configuration option. So, here are the instructions for building on Linux.

1. Install MonoDevelop for your version of Linux

2. Install git for your version of Linux

3. Download the EduNetworkBuilder source code.

   $ git clone https://git.solidcharity.com/timy/EduNetworkBuilder

4. Choose which git branch you want to use (optional)

   $ cd EduNetworkBuilder

   $ git checkout Development

5. Change the EduNetworkBuilder.csproj file

   Find the line that says:

   <GenerateManifests>true</GenerateManifests>
   

   Change it to read:

   <GenerateManifests>false</GenerateManifests>   
   

6. Run MonoDevelop (use the instructions for your specific operating system)

7. Find and open the EduNetworkBuilder.sln file

8. Tell EduNetworkBuilder to build using the MonoDevelop interface

9. Find the exe in the build directory. Chmod that to make it executable, and put it wherever you want it to go:

   $ find . | grep EduNetworkBuilder.exe

   $ chmod 755 [EduNetworkBuilder.exe path]

   $ mv [EduNetworkBuilder.exe path] /usr/local/bin