First Steps

This page contains instructions on how to obtain the OpenNetinf source, create a working environment and start developing.

The instructions are currently only available for Linux-based systems. However, you can also run the OpenNetInf code on Windows-based machines. In addition, you can download the Virtual Machine (link on the right) that contains a Linux installation, the preinstalled and preconfigured OpenNetInf code, and an Eclipse development environment.

A very good starting point to get an overview of OpenNetInf is the documentation.

Using the VM

VM Screenshot, Menus
The above screenshot shows all the relevant menus of the VM main desktop. They are (left to right, top to bottom)

  • The Maintenance Menu (gear symbol) with
    • the Terminal starter which opens a terminal in the repository directory,
    • the configuration editor which opens the VM build system configuration file (tested in beta3 only),
    • the build starter which starts a build of the Netinf code (tested in beta3 only), and
    • the Updater which updates the local repository copy from the Google repository
  • The Application Menus (Firefox and Thunderbird symbols) which start those applications either in their original configuration or with NetInf plugins (tested in beta3 only)
  • The Eclipse Startes (Eclipse symbol) which starts the Eclipse IDE with pre-imported source projects (the starting point for your developement work
  • The Scenario Menus (S1 and S2 symbols) which contain starters for the demo scenarios as mentioned in the documentation (tested in beta3 only)

Automatic Installation

  • Get the installer script from here
  • Make it executable
    # chmod 750 mkEnv
  • Edit it to match your environment!
  • Execute it
    # ./mkEnv

Manual Installation

    • Select a location for the new environment (e.g. ~/OpenNetInf) and create the folder
      # mkdir ~/OpenNetInf
    • Change into that folder
      # cd ~/OpenNetInf
    • Check out the repository into a subfolder named "repository"
      # hg clone repository


  • You should now obtain an installation file for eclipse
    eclipse-java-helios-SR1-linux-gtk.tar.gz (for 32bit) or
    eclipse-java-helios-SR1-linux-gtk-x86_64.tar.gz (for 64bit)
    from the official site
    and save it to your environment folder
    (you now have a file named ~/OpenNetInf/eclipse-(...).tar.gz
  • Change into your environment directory
    # cd ~/OpenNetInf
  • Unpack eclipse (will go into its own subdirectory)
    ! replace (...) with actual filename !
    # tar xvzf eclipse-(...).tar.gz
  • Start eclipse
    # ./eclipse/eclipse &
  • Choose a subdirectory of your environment as your workspace
    (e.g. ~/OpenNetInf/workspace) - will be created automatically!
  • Import all projects in ~/OpenNetInf/repository/src/ into workspace
  • Get the IvyDE plugin and install it in eclipse
  • Clean the eclipse projects, Ivy should resolve all the necessary libraries automatically and will download them from the internet if needed