The TOFFEE Project
The TOFFEE Project

Documentation :: TOFFEE-Mocha Documentation :: TOFFEE-Mocha-1.0.32-1-x86_64 and TOFFEE-Mocha-1.0.32-1-i386

Written by: Kiran Kankipati - Published: 31-Oct-2016


Download TOFFEE-Mocha-1.0.32-1-x86_64 over HERE via Google Drive share.

Download TOFFEE-Mocha-1.0.32-1-i386 (Intel x86 32-bit) over HERE via Google Drive share.

Software Development Update(s) corresponds to this TOFFEE-Mocha release version:
NEWS :: TOFFEE-Mocha WAN Emulation software development - Update: 20-Oct-2016

Release Notes:
NEWS :: TOFFEE-Mocha-1.0.32-1-x86_64 and TOFFEE-Mocha-1.0.32-1-i386 Code Release

WAN Emulator within VirtualBox VM:
Video DOC :: Setting up a WAN Emulator (TOFFEE-Mocha) within VirtualBox

User Guide (Documentation)
The TOFFEE-Mocha release is highly optimized and customized for generic x86-64/i386 hardware platforms. Once you extract the downloaded tar-ball you can find the pre-compiled binary files as well the source-code as shown below.

kiran@WD-1TB2:/code/release/TOFFEE-Mocha-1.0.32-1-x86_64$ ls -l
total 56744
drwxr-xr-x  5 kiran kiran     4096 Oct 23 17:36 daemon
drwxr-xr-x  4 kiran kiran     4096 Oct 30 20:24 gui
-rw-r--r--  1 kiran kiran     2947 Jun 17 11:58 LICENSE.txt
drwxr-xr-x 29 kiran kiran     4096 Oct 30 21:45 linux-4.8.0-25-ubuntu
-rw-r--r--  1 kiran kiran  8584614 Oct 30 20:55 linux-headers-4.8.0-toffee-mocha-1.0.32_30-oct-2016_amd64.deb
-rw-r--r--  1 kiran kiran 49498850 Oct 30 20:53 linux-image-4.8.0-toffee-mocha-1.0.32_30-oct-2016_amd64.deb
-rw-r--r--  1 kiran kiran     1660 Jun 17 12:01 README.txt

and in i386 version:

kiran@ubuntu-1610-i386:/code/release/TOFFEE-Mocha-1.0.32-1-i386$ ls -l
total 54968
drwxr-xr-x  5 kiran kiran     4096 Oct 30 21:43 daemon
drwxr-xr-x  4 kiran kiran     4096 Oct 30 21:43 gui
-rw-r--r--  1 kiran kiran     2947 Jun 17 11:58 LICENSE.txt
drwxr-xr-x 29 kiran kiran     4096 Oct 30 23:48 linux-4.8.0-25-ubuntu
-rw-r--r--  1 kiran kiran  8557228 Oct 30 23:18 linux-headers-4.8.0-toffee-mocha-1.0.32_30-oct-2016_i386.deb
-rw-r--r--  1 kiran kiran 47704820 Oct 30 23:14 linux-image-4.8.0-toffee-mocha-1.0.32_30-oct-2016_i386.deb
-rw-r--r--  1 kiran kiran     1660 Jun 17 12:01 README.txt

NOTE: For more details regarding TOFFEE-Mocha hardware test setup and deployment kindly refer: TOFFEE-Mocha WAN emulator Lab deployment and topology guide

Installation TOFFEE-Mocha contains two parts namely web-based GUI and the custom Linux Kernel which contains TOFFEE-Mocha within it. So here are the step by step instructions you can follow to install the same.

Step 1: Install the Ubuntu 16.10 Desktop x86-64 (64-bit) on a fresh system and for 32-bit x86 install Ubuntu 16.10 Desktop i386.

NOTE: From this point onwards I am going to walk you through the steps which you can follow on a x86_64 install. You can follow the same equivalent steps for an i386 install too.

Step 2: Before installing TOFFEE-Mocha GUI you have to install all the prerequisite dependencies. As a part of dependencies TOFFEE-Mocha needs MySQL (now MariaDB, PHP, and other applications). So make sure device is connected to internet. The script below will install everything and configures MySQL TOFFEE-Mocha GUI database and tables for you. So enter into the .../gui folder, then execute the script as shown below:

kiran@ubuntu-16:~/TOFFEE-Mocha-1.0.32-1-x86_64/gui$ ls
db_scripts.sql  etc  html  make_clean  make_clean.php  make_install  make_install_deps  make_install.php  toffeemochad
kiran@ubuntu-16:~/TOFFEE-Mocha-1.0.32-1-x86_64/gui$ sudo ./make_install_deps

After sometime it will install MySQL server and prompts the default password for the user root. Kindly enter the password "welcome" when it prompts for MySQL root password as shown below:
mysql server defaut password

Step 3: Now you need to install the GUI web-pages in Apache web-root (such as in /var/www/html/toffee_mocha) and install the TOFFEE-Mocha Daemon. The script below does all these jobs:

kiran@ubuntu-16:~/TOFFEE-Mocha-1.0.32-1-x86_64/gui$ sudo ./make_install
Failed to stop toffeemochad.service: Unit toffeemochad.service not loaded.
Failed to stop toffeemochad.service: Unit toffeemochad.service not loaded.
Installing TOFFEE-Mocha GUI in (/var/www/html/toffee_mocha) Apache default webroot folder ...
cp: target '/var/www/html/toffee_mocha/.' is not a directory
Done !
Setting Appropriate Permissions in (/var/www/html/toffee_mocha) Apache default webroot folder ...
chmod: cannot access '/var/www/html/toffee_mocha/*': No such file or directory
Done !

NOTE: Ignore any warnings and in few cases even any errors displayed.

Step 4: TOFFEE-Mocha Linux-Kernel Installation:
kindly install the following ".deb" binary files as shown below:

kiran@ubuntu-16:~/TOFFEE-Mocha-1.0.32-1-x86_64$ sudo dpkg -i 

Once it is done, you can reboot the system, boot in the new TOFFEE-Mocha Kernel and can configure and use the same.

NOTE: Ignore any warnings.

Once you are done with Installation, you can restart the system and configure the same as shown below.

Now you can access the TOFFEE-Mocha GUI via your browser as shown below. The default username is: root and the password is: welcome

URL: http://localhost/toffee_mocha
1 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator Login

Once you login you will get this first HOME page. Since it is not yet configured and not yet active, there are no graphs populated in the home page.
2 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator Home

Network Ports You can check (or view) your hardware network ports here: Settings -> Ports
3 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator device ports

You can now configure TOFFEE-Mocha directly via Wizard by clicking "+ Wizard" on the side menu bar. Once you get the Wizard page, you can now select "Start" button. This button will reset everything and prepares for a fresh configuration.
4 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator wizard start

Select your LAN Port.

IMPORTANT NOTE: Since TOFFEE-Mocha device is a WAN emulator device you can configure any port as LAN port and WAN port in general. Swapping LAN and WAN ports in your deployment will not cause any issues in most cases. However (unlike older versions of TOFFEE-Mocha) if you choose to use upload/download constant delay feature, then set your WAN/Internet port and LAN port accordingly.

5 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator set LAN port

Select your WAN Port. As suggested in the note above, you can configure any port as WAN port.
6 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator set WAN port

Now your TOFFEE-Mocha basic setup is over. Now you should get the confirmation page as shown below.
7 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator wizard finish

Optionally you can now check various tabs under the Settings tab. For example the "+ Ports" tab shows the status of various network ports and its corresponding Direction (such as LAN and WAN) and other generic port related information. Sometimes you can directly set port direction via this page, but it is highly recommended to use the TOFFEE-Mocha Wizard.

NOTE: TOFFEE-Mocha works within Linux based Layer-2 bridging module. And hence once TOFFEE-Mocha is configured via Wizard you should able to see the bridging port name as "toffee-mocha" as shown below. This bridging interface is created by the user-space TOFFEE-Mocha daemon automatically so that the Kernel-space TOFFEE-Mocha hooks, intercepts and optimizes the packets passing through standard Linux kernel bridge.

8 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator toffee-mocha bridge port

Packet Delay Feature: As the name says you can add constant or dynamic packet delay on each packet passing through TOFFEE-Mocha. This will simulate slow speed WAN links. This will limit the rate of packets there by indirectly controlling the rate of bits-per-second data transmission. As one can understand this gives more finer and precise control over packets than the standard Linux QoS tc scripts. You can add inter-packet milliseconds and microseconds constant delay. As well you can add per-packet dynamic delay based on the size of the packet (i.e delay proportional to number of bytes per packets). Dynamic delay rate can be controlled by the dynamic delay factor variable. Dynamic delay is a unique feature through which you can simulate a kind of burst type traffic and so latency associated with the same. In any case you can use combination of both dynamic and constant delay parameters. The overall delay of the packet will be the total delay set by all these settings. You can also skip delay of few packets randomly via Random Delay feature.

NOTE: For more details kindly refer Help embedded within these individual settings pages.

NOTE: For more details of the new TOFFEE-Mocha-1.0.32 asymmetric constant packet delay feature kindly refer: TEST CASES :: TEST RESULTS :: TOFFEE-Mocha-1.0.32 asymmetric constant packet delay feature

9 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator packet delay settings

Packet Drop Feature: As the name says you can randomly drop few packets passing through TOFFEE-Mocha. This will simulate real worst-case WAN network scenarios such as mobile internet (3G/4G networks), Satellite Networks, in-flight WiFi, marine internet, etc. You can control the packet drop rate with the random packet drop factor variable as shown below. The value 1 denotes 1 in every 10 random number range. And 2 denotes 1 in every 20 and so on. So higher the drop factor lesser is the probability of packets getting randomly dropped.

NOTE: Packets dropped this way will reflect in the TOFFEE-Mocha stats. You can see the bytes and packets received vs transmitted in the stats. As well the overall stats reports in the first TOFFEE-Mocha home page.

10 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator packet drop settings

TOFFEE-Mocha Big Picture: You can view and confirm your settings via "+ Big Picture" any time. Big Picture is a neat graphical illustration of your overall TOFFEE-Mocha settings. You can view any time as a reference and even print and file it as a record if you are a Network Admin. You can assume big picture is a kind of graphical variant of a typical CISCO Device show running-config (show run) command output.
11 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator big picture

Once your complete TOFFEE-Mocha setup is done and assume you have deployed the same within your other lab testing equipment. You can now test with live traffic and monitor the TOFFEE-Mocha run-time live performance stats as show below:

TOFFEE-Mocha Packet Bytes statistics graphs:
12 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator packet bytes stats

TOFFEE-Mocha Packet statistics (count) graphs:
13 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator packet count stats

Here is the TOFFEE-Mocha consolidated home page report:
14 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator Home page consolidated reports

TOFFEE-Mocha About: Any time you can check the version and other information of this specific TOFFEE-Mocha release from its About page:
15 TOFFEE-Mocha-1.0.32-1-x86_64 WAN Emulator About page

TOFFEE-Mocha Sample Deployment and Tests: Here is my HP-Laptop and Dell-Laptop connected via TOFFEE Mocha device. I did few ping tests and wget HTTP file downloads on my HP Laptop by accessing remotely connected Dell-Laptop via TOFFEE-Mocha.
16 TOFFEE-Mocha-1.0.18-1-x86_64 WAN Emulator Ping tests
17 TOFFEE-Mocha-1.0.18-1-x86_64 WAN Emulator wget http file download tests
18 TOFFEE-Mocha-1.0.18-1-x86_64 WAN Emulator network activity

Suggested Topics:

TOFFEE-Mocha - WAN Emulator
TOFFEE-Mocha Documentation :: TOFFEE-Mocha - Jitter feature
Setting up a WAN Emulator within VirtualBox
TEST CASES :: TEST RESULTS :: TOFFEE-Mocha-1.0.32 asymmetric constant packet delay feature
TOFFEE-Mocha Documentation :: TOFFEE-Mocha-1.0.32-1-x86_64 and TOFFEE-Mocha-1.0.32-1-i386
TOFFEE-Mocha Documentation :: TOFFEE-Mocha-1.0.18-1-x86_64
TEST CASES :: TEST RESULTS :: TOFFEE-Mocha-1.0.14 Development version
TEST CASES :: TEST RESULTS :: Raspberry Pi WAN Emulator TOFFEE-Mocha-1.0.14-1-rpi2
TOFFEE-Mocha WAN emulator Lab deployment and topology guide
TOFFEE-Mocha Documentation :: TOFFEE-Mocha-1.0.14-1-rpi2 - Raspberry Pi WAN Emulator
TOFFEE-Mocha Documentation :: TOFFEE-Mocha-1.0.14-1-x86_64
TOFFEE-Mocha License

TOFFEE-DataCenter - WAN Optimization
TOFFEE - WAN Optimization
TOFFEE-Mocha - WAN Emulator
TOFFEE-Butterscotch - Save and Optimize your Internet/WAN bandwidth

The TOFFEE Project - v5.28 :: Updated: 06-Sep-2017 :: © 2017 :: Author: Kiran Kankipati