Use IPOP on Ubuntu and Raspberry Pi, Manually

  Description
Tested on Ubuntu 16.04 and 18.04 x64
Raspbian Jessie and Stretch on Raspberry Pi 3
Raspbian Stretch on Raspberry Pi Zero
Time ~ 10 Minutes
Question(s) - How to install IPOP?
- How to run IPOP?
- How to remove IPOP?
Objective(s) - Install IPOP
- Run IPOP
- Stop IPOP
- Remove IPOP

Download and Install Dependencies

sudo apt-get update -y
sudo apt-get install -y python3 python3-pip iproute2 openvswitch-switch 
sudo -H pip3 install psutil sleekxmpp requests

Get IPOP Binary

Download the proper version of IPOP from our latest release.

Then go to the download directory and extract the file (Put in the actual file name):

tar -xzvf ipop-vxxx.tar.gz
cd ipop-vxxx

Copy Configuration File

You will need a valid configuration file (ipop-config.json) to run IPOP. Go to the directory you have your config file and copy the file to the config directory:

cp PATH/TO/CONFIGFILE/ipop-config.json config/

Run IPOP

Run IPOP TinCan

sudo ./ipop-tincan &

Run IPOP Controller

python3 -m controller.Controller -c ./config/ipop-config.json &

Now, if everything is going well, IPOP should be run.

Stop IPOP

Stop IPOP Tincan

sudo killall ipop-tincan  

Stop IPOP Controller

ps aux | grep -v grep | grep controller.Controller | awk '{print $2}' | xargs sudo kill -9

Remove IPOP

To uninstall IPOP, its is safe to stop it first and then remove the IPOP execution directory.


Key Points Summary

  • Run IPOP:
sudo ./ipop-tincan &
python3 -m controller.Controller -c ./config/ipop-config.json &
  • Stop IPOP:
sudo killall ipop-tincan  
ps aux | grep -v grep | grep controller.Controller | awk '{print $2}' | xargs sudo kill -9