New netlab Installation Instructions

A long-time subscriber with a knack for telling me precisely why something I’m doing sucks big time sent me his opinion on netlab1 installation instructions:

I do not want to say it is impossible to follow your instruction but I wonder why the process is not clearly defined for someone not deeply involved in such tasks with full understanding of why to install from github, etc..

Many guys do not know if they want to use libvirt. They want to use the tool simple way without studying upfront what the libvirt is - but they see libvirt WARNING - should we install libvirt then or skip the installation?. But stop, this step of libvirt installation is obligatory in the 2nd Ubuntu section. So why the libvirt warning earlier?

I believe we should start really quickly to enjoy the tool before we reject it for “complexity”. Time To Play matters. Otherwise you are tired trying to understand the process before you check if this tool is right for you.

He was absolutely right – it was time to overhaul the “organically grown” installation instructions and make them goal-focused and structured. For those of you who want to see the big picture first, I also added numerous (hopefully helpful) diagrams. The new documentation is already online, and I’d love to hear your feedback. Thank you!


  1. netlab was known as netsim-tools at that time. ↩︎

1 comments:

  1. Hi Ivan, would Windows Hyper-V support be possible? That would be in line with Linux where also the native virtualization support is used.

    Replies
    1. Of course. There's no "this is how you add a new provider" documentation at the moment, but it's not THAT hard.

      First you have to figure out what provisioning system to use. Vagrant has a hyper-v provider, so that's a pretty good start.

      Next you have to choose the devices you want to support under Hyper-V, create build recipes for them (nobody is shipping Vagrant boxes for Hyper-V), and create corresponding Vagrantfile templates. You'll also have to figure out how to create virtual networks with Hyper-V provider.

      You'll also have to add the new provider to system settings etc. At that point you might need help: you can open a GitHub issue, ask a question in #netsim-tools channel in Network2Code Slack team, or send me an email.

      When you're done, update the documentation and submit a PR against the dev branch.

      Good luck!

Add comment
Sidebar