Netkit

Q01: Where can I find documentation about Netkit?

A01: The documentation of Netkit is available in two forms. If Netkit is installed properly, its man pages contain detailed instructions about the user interface and the steps to prepare virtual labs, as well as directions to modify Netkit with customized kernels or filesystems. The man pages can be obtained by typing man page_name at a shell prompt (a suggested starting point is man netkit).

Moreover, documentation about specific networking topics is available in the form of lecture slides that are available on the Labs & Slides page.

Q02: Where can I learn how to set up a redistributable virtual lab?

A02: Detailed instructions to prepare a Netkit lab are available in the man page of lstart.

As a starting point to create a Netkit lab, you can use one of the ready-to-use labs published in the Labs & Slides page. Alternatively, you can download the contributor's pack from the Contributed Labs page, which provides the skeleton of a basic lab and a template to prepare lecture slides that can be used as a starting point.

Q03: How can I move files from/to a virtual machine to/from my host?

A03: Inside every virtual machine there is a special directory named /hosthome. This directory points to your home directory on the host (typically, /home/username). Hence, anything you write into /hosthome will be made available on the host, and you can bring host files into your virtual machine as well.

Q04: I would like to customize Netkit by using a kernel that I have compiled on my own. Is it possible?

A04: Of course it is. vstart provides the option --kernel, which allows to start a virtual machine with a custom kernel. Alternatively, setting the environment variable NETKIT_KERNEL tells Netkit to use the specified kernel for any newly started virtual machine, including those that are part of virtual labs. If you are setting up a lab in which only some virtual machines need to use a different kernel, you can put inside lab.conf an entry like the following:

vm[kernel]=path_to_the_kernel

Instructions about how to build your own custom kernel for Netkit are provided inside the man page netkit-kernel.

Q05: When I try to start a virtual machine, nothing happens or an xterm window pops up and immediately disappears. It looks like Netkit is crashing. What can I do?

A05: First of all, check whether there are known issues with the host Linux distribution you are running. You can find the support status for most distributions in the Status page.

If none of the entries in the above page applies, or if you still experience the problem after applying the suggested fixes, proceed as follows.

1. Run the script check_configuration.sh provided with Netkit to check that every required package is properly available.
2. Check if you can start an xterm alone by typing xterm inside a terminal window. If you can't, check your xterm installation.
3. If you are booting a virtual machine that had already been started previously, attempt to remove its .disk file and try again.
4. If you are forcedly starting a virtual machine with a different version of the filesystem (i.e., with the option -m of vstart), Netkit may be unable to mount it properly. Try adding the option --append=root=98:1 to vstart.

Double check whether one of the above tests solves your issue.

If it is not the case, you should look deeper into the problem. Therefore, start a virtual machine with a higher level of verbosity:

vstart vm --verbose --con0=this

Q06: I would like to set up a lab with a virtual machine connected to the Internet. How can I do that?

A06: Connecting a virtual machine to an external, real network (being it the Internet or not) requires you to have the root password handy. In order to attach virtual interface eth0 to a real network, you should pass to vstart an option like:

--eth0=tap,TAP-ADDRESS,GUEST-ADDRESS

If you want to set up a lab in which a virtual machine has an Internet connected interface, you can add an option like the following inside your lab.conf:

vm[eth0]=tap,TAP-ADDRESS,GUEST-ADDRESS

• it is not (yet) possible to use the standard syntax (vm[0]=...) for this kind of interfaces;
• the root password is only asked for the first tap interface used in the lab;
• the TAP-ADDRESS is only applied for the first virtual machine that is started with a tap interface: from then onwards, using a different TAP-ADDRESS for a different interface, even in a different lab, has no effect. If you want to reset the TAP-ADDRESS you need to stop all your virtual machines and launch

  vclean -T

  As Netkit uses NAT, the specific TAP-ADDRESS being used is not relevant and in general there is no need to change it "on the fly". For this reason, the above command is rarely used.

Q07: How can I install/upgrade packages or other additional software inside Netkit?

A07: In principle, there are two ways of doing this.

One is to use an Internet connected virtual machine. You can configure a virtual machine to connect to the Internet by using tap interfaces (see the man page of vstart for more information). So, for example, you would type:

vstart vm --eth0=tap,10.0.0.1,10.0.0.2 -M 256 -W

Once vm has started, configure a name server inside its resolv.conf file and run the following commands:

apt-get update

apt-get install package_name

If the product you want to install is not available as a Debian package, you may download it inside virtual machine vm by using a command like:

wget http://some.download.location/dir/download_me.tar.gz

If the downloaded package consists of source code, in order to be able to compile it you may need to install at least the following packages, which are not provided with Netkit: gcc g++ make binutils automake autoconf.

After installing the package, remember to safely halt the virtual machine by using halt or vhalt. Failure to do so would result in a corrupted model filesystem, which causes all virtual machines launched from now onwards to perform a check upon their boot.

An alternative solution is to mount the model filesystem on the host and to perform the installation without starting any virtual machine. To proceed in this way, you require root privileges on your host. First of all, mount the Netkit filesystem inside an empty directory (in this case, /mnt/nkfs):

mount -o loop,offset=16384 $NETKIT_HOME/fs/netkit-fs /mnt/nkfs

chroot /mnt/nkfs

Now configure a name server inside /etc/resolv.conf (remember that this only affects the /etc/resolv.conf in the Netkit filesystem). At this point, you can proceed normally with the package installation as explained above:

apt-get update
apt-get install package_name

After installing the package, quit the shell by typing exit. This brings the root (/) directory back to its original location: every change applied from now onwards affects the filesystem of your host!

Remember to unmount the Netkit filesystem before performing any other operation:

umount /mnt/nkfs

Q08: I would like to start an application that has a graphical user interface inside Netkit. How can I do that?

A08: You can't. Netkit has not been conceived as a product to experiment with GUIs. Most networking applications are distributed as command-line tools or have an equivalent command-line version. Since Netkit aims at providing an environment to experiment with networking, in most cases it is enough to take advantage of these text-mode utilities to perform the required analyses. This also reduces the size of the filesystem and makes virtual machines more lightweight.

In principle, using graphical applications would be possible by forcing them to connect to the host's X server. However, no X clients are currently installed in Netkit, which means that there are no graphical tools to play with.

A more correct approach is to collect the required information (e.g., a packet trace) inside the virtual machines by using a command-line tool (e.g., tshark), save it to a file on the host and then open it with a graphical analyzer on the host (e.g., wireshark) to perform investigations.

Q09: How can I know whether Netkit supports a given technology?

A09: There are several places where you can look for this piece of information, depending on which Netkit component provides the support.

One possibility is to look at the Features page, which provides a high level overview of the available tools and technologies inside Netkit.

Another possibility is to browse through the list of packages installed in the Netkit filesystem, which is available in the Download page. Here you can find the user space applications that are available in Netkit, including network tools such as ping, traceroute, tcpdump, etc.

Support for some lower level features (e.g., IPv6) must be typically compiled in the kernel. If you want to know whether the kernel of Netkit supports a particular technology, you can check its configuration file, which is again available in the Download page.

Q10: Which host architectures Netkit does Netkit run on? Are 64 bit processors supported? What about my PowerPC based Mac?

A10: As of October 2007, Netkit can only run on 32 bit i386 based hosts. Porting to different architectures (e.g., PowerPC) is currently not planned, even if 64 bit hosts are likely to be supported in the future.