Running SocialVPN on Linux Update

Running SocialVPN on Linux Update

These instructions are for Ubuntu 12.04 or higher or Debian Wheezy (64-bit). Visit the downloads page to get packages for additional platforms.

Download and configure SocialVPN

1. Download and extract the controller framework

   wget -O controller-framework-beta-v0.3.1.tar.gz https://goo.gl/e7BSpo
   mkdir controller
   tar xvzf controller-framework-beta-v0.3.1.tar.gz -C controller
   cd controller
   

This will extract the framework into the controller directory. Please do not change the directory controller to others as it will be used in the following steps.

2. Modify module/svpn-config.json according to the requirement. Add xmpp_username, xmpp_password and xmpp_host to the config file and ensure that the IP addresses are different for all the nodes.

   {
   "xmpp_username": "username@host",
   "xmpp_password": "enter-password-here",
   "ip4_mask": 24,
   "xmpp_host": "dukgo.com",
   "stat_report": true,
   "tincan_logging": 0, <mark>
   "controller_logging": "DEBUG" <mark>
   }
   

After starting IPOP-Tincan, you can either run the GroupVPN controller or the SocialVPN controller.

Running SocialVPN

1. First, you need to start the ipop-tincan program

   chmod 700 ipop-tincan-x86_64
   sudo sh -c './ipop-tincan-x86_64 1> out.log 2> err.log &'

Note: use "ipop-tincan-x86" in place of "ipop-tincan-x86_64" for 32-bit Ubuntu machine.

2. Second, start the SocialVPN controller with the configuration file you created:

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

3. Check on the current status of your network. This will show you the IP addresses of other nodes connected to your SocialVPN:

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

By default, addresses are assigned dynamically on a round-robin fashion. Alternatively, you can assign addresses for your peers yourself through an additional configuration file. Please refer to our FAQs for details.

4. Check the network devices and ip address for your device

   ifconfig ipop

   

5. Run SocialVPN on another machine using the same credentials and they will connect with each other.

Killing the Controller

Find out the process IDs of IPOP Tincan and IPOP Controller using the following command

``` bash
netstat -ntulp
```

Kill the processes

``` bash
kill -9 <process id>
```

Note: use "ipop-tincan-x86" in place of "ipop-tincan-x86_64" for 32-bit Ubuntu machine.