EduNetworkBuilder/README.md

91 lines
3.4 KiB
Markdown

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.com/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