Added instructions for building for Linux

This commit is contained in:
Tim Young 2017-06-16 15:38:02 -05:00
parent 77ce6a1106
commit 17b58fc094

View File

@ -1,5 +1,40 @@
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 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 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
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 ***
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>true</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