Skip to content

Installing

Caio edited this page Oct 9, 2015 · 31 revisions

Home | Installing | Tutorial | GUI | Node Classes | Topology Generators |Routing | Publications | Related Projects


In order to install Mini-CCNx, follow the steps below. All of them are required!

What equipment will I need ?

Basically, you'll need a laptop/desktop with a recent Linux distro (Ubuntu, Fedora). We recommend Ubuntu. For this guide, the Ubuntu 12.04 LTS was used. Also, note that you'll need administrative privileges in order to download and install extra packages and also to execute Mini-CCNx.

Installing CCNx

Each node in Mini-CCNx will run the official implementation of CCNx. Let's get it.

In the Project CCNx webpage, you'll find all the details for installing the CCNx. See Installing CCNx, or this alternative source. To use Mini-CCNx you won't need to create the init script as outlined in the first link. But please, pay attention to the necessary pre-requisite packages, as they are, indeed, necessary.

The new installation script prompts the user to try to automatically install CCNx 0.8.2 and its dependencies. It should fine, but any problems please refer to the links above.

Now, to Mini-CCNx itself.

Downloading and installing Mini-CCNx

If you don't have it yet, you'll need to have git installed first. In Ubuntu, that would be:

sudo apt-get install git

For a fast and simple guide on the GitHub system, please refer to GitHub Simple Tutorial.

Now, let's get the source code of Mini-CCNx. Go to your home directory and use the following command:

git clone git://github.com/chesteve/mn-ccnx

As result, there will be a directory named mn-ccnx in your home directory, containing all the source code.

Still in your home directory, use the utility install script with the -fnv options:

sudo ./mn-ccnx/util/install.sh -n

Pre-requisite packages will be downloaded and installed during the process, including InfluxDB for storing metrics gathered during experiments and ccnping to test connectivity between CCN hosts.

Using the pre-configured VM

You can download a pre-configured VM, with ccnx-0.8.2 and Mini-CCNx already installed here (.zip) and [here] (https://copy.com/T7NJ3QmdUtttnxSa) (.bz2)

If you have problems with the links above, you can try [this one] (https://intrig.dca.fee.unicamp.br:8840/owncloud/index.php/s/LV1vGryUQcp3SNp) (.zip) or [this one] (https://intrig.dca.fee.unicamp.br:8840/owncloud/index.php/s/gXYje1K1ir1AXV5) (.bz2) but you will have to add a security exception in your browser.

It is in the .vdi format, and you can use it with Oracle VirtualBox (Linux, Windows or MAC). It might work in other virtualization platforms (not tested though).

The username and password are:

  • username = user
  • password = user

user is in the sudoers list, so you can run Mini-CCNx with sudo and user.

Clone this wiki locally