IPOP Controllers

Prerequisites

Obtain IPOP-Controllers by downloading the latest archive from the releases or by cloning this repository: git clone https://github.com/ipop-project/controllers.git

Obtain IPOP-Tincan by downloading the latest archive from the releases or by building from source [2].

Usage

Running SocialVPN

Change current directory to controller.

cd controllers/controller/
Copy sample-svpn-config.json to svpn-config.json and modify it as per your requirements to configure the controller [1].

nano modules/svpn-config.json
Run IPOP-Tincan.

cd ../..; sudo ./ipop-tincan-x86_64 &> tin.log &

Run SocialVPN Controller.

Make sure you return to the /controllers/ directory.

cd controllers
python -m controller.Controller -c controller/modules/svpn-config.json &> log.txt &

Check status.

echo -e '\x02\x01{"m":"get_state"}' | netcat -q 1 -u 127.0.0.1 5800

Running GroupVPN

Change current directory to controller.

cd controllers/controller/
Copy sample-gvpn-config.json to gvpn-config.json and modify it as per your requirements to configure the controller [1].

nano modules/gvpn-config.json
Run IPOP-Tincan.

cd ../.. ; sudo ./ipop-tincan-x86_64 &> tin.log &

Run GroupVPN Controller.

Make sure you return to the /controllers/ directory.

cd controllers
python -m controller.Controller -c controller/modules/gvpn-config.json &> log.txt &

Check status.

echo -e '\x02\x01{"m":"get_state"}' | netcat -q 1 -u 127.0.0.1 5800

Killing IPOP

The following commands will search the PID of IPOP-Tincan and IPOP-Controller and dispatch a kill signal.

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

Notes

[1] See https://github.com/ipop-project/documentation/wiki/Configuration for a detailed description of options for controller configuartion.

[2] See https://github.com/ipop-project/documentation/wiki under Building the code for guides on building IPOP-Tincan from source.