Compile from source

Contents

Introduction

If for some reason you are not able to install Net Responsibility (NR) from a package, you may be able to compile and install it from the source code using the following instructions.

New to Linux/Ubuntu? Read this article for some helpful info: Where's the Terminal?. Warning: Read this (post by jdong, Nov 18, 2007 - Jan 31, 2013) before copying/pasting anything into the terminal. Basic rule: Take time to make sure you have at least a basic idea of what and why you are running a certain command in the terminal.

Please note the following:

1. Before installing Net Responsibility (NR), you'll need to register an account if you haven't already.

2. Older versions are provided but not recommended. You may find them here.

3. Necessary packages that are needed for compiling will need to be installed (if they are not already) before you can successfully complete the following steps. On an Ubuntu system, you should be able to do this by making sure the build-essential package is installed, since this results in the installation of a group of compiling-related packages that are needed for doing any Debian package building. This package might not be installed by default in your version of Ubuntu.

POCO libraries

You will first need to install the POCO libraries. Note that the version needs to be 1.4 or later. Some platforms have these libraries precompiled and packaged. Otherwise you need to compile them yourself. Start by downloading the complete edition (i.e. not the basic edition). Unpack (extract) it (on a platform like Ubuntu, this can often be done by right-clicking on the file and choosing the unpack/extract option from the menu), which will result in the creation of a directory (folder) with the same name as the file you downloaded, and which contains other folders and files. If you want, you can unpack the file to one directory and then copy the extracted contents to another directory where you will work with it. Once you have the POCO folders and files in the directory you want them, you then need to open a terminal window and use the cd command to move yourself to that directory. While there you then need to do three things: configure, compile and install. For a user who has chosen to use the /home/name/poco directory, the procedure should look like this:

cd /home/name/poco
./configure --shared --no-tests --no-samples
make
sudo make install

Note: If you are not an Ubuntu/Debian user, for the last command you may need to change sudo to su. The main thing to know is that the make install command needs to be run as 'root', however your particular platform handles that.

Need for libpcap library

You also will need to have the libpcap library installed. Many systems either have it installed by default, or provide packages for it that can be installed by the user. You may see that your system already has a libpcap package installed, but if your system also has a libpcap-dev package available, you need to make sure that is installed as well.

Net Responsiblity

Once you have the POCO libraries and libpcap successfully installed, you can move on to compiling and installing NR itself, which can be done in a similar way to the process shown above for the POCO libraries. Download and unpack the tarball (i.e, archive file). Then open a terminal window to configure, compile and install. For a user who has put the unpacked contents of the tarball into the /home/name/netresp directory, the procedure should look like this:

cd /home/name/netresp
./configure
make
sudo make install

Note: If you are not an Ubuntu/Debian user, for the last command you may need to change sudo to su. The main thing to know is that the make install command needs to be run as 'root', however your particular platform handles that.

During the last step, you need to enter a username and password. Simply use the same as you did when registering your NR account.

Testing the installation

If you've successfully worked through the steps above, NR should now be installed. If you want to test to see if it is running as it should, see the Troubleshooting Installation and Configuration guide for instructions on the best way to do this.