10. Appendix: Installing Lagopus vswitch on VirtualBox VM

This section describes how to install Lagopus on VirtualBox VM.

10.1. Software Versions

10.2. About VirtualBox

ORACLE VirtualBox is x86 and AMD64/Intel64 virtualization product which is freely available as Open Source Software under the terms of the GNU General Public License (GPL) version 2.

You could run VirtualBox on host OS running Windows, Linux, Macintosh, and Solaris.

Refer to the VirtualBox web site For more information about VirtualBox.

10.3. Download and Install VirtualBox

10.4. Create VM

  • Start “Oracle VM VirtualBox Manager” (Management GUI)

  • Click “New”

    _images/virtualbox-001.png
  • Enter Name (=any), Type (=Linux), Version (=Ubuntu (64-bit)).

    _images/virtualbox-002.png
  • Set Memroy Size (>=2GB recommended. 3GB in this example.)

    _images/virtualbox-003.png
  • Set Hard disk size (default = 8.00 GB)

    _images/virtualbox-004.png
  • Set Hard disk file type: default = VDI (VirtualBox Disk Image)

    _images/virtualbox-005.png
  • Set Storage on physical hard disk: default = Dynamically allocated.

    _images/virtualbox-006.png
  • Set File location and size: default folder name = Name of the VM you’ve specified.

    _images/virtualbox-007.png
  • Click “Create” and VM will be created.

10.5. VM Network Setting

10.5.1. Add two (2) new adapters as data ports used by Lagopus.

  • Adapter 1 (available by default)
    • management port (Internet access, SSH from Host OS)
  • Adapter 2/3 (new)
    • Lagopus data ports

Steps:

  • Select VM you just created. Right click and select “Settings”

    _images/virtualbox-008.png
  • Select “Network” -> “Adapter 2” and configure below. Do the same for “Adapter 3” as well.

    • Enable Network Adapter: enable
    • Attached to: Internal Network
    • Name: intnet02 (intnet03 for Adapter 3)
    • Advanced: Adapter Type: Intel PRO/1000 MT Server (82545EM)
    • Advanced: Promiscuous Mode: Allow All
    _images/virtualbox-009.png

    Note

    NIC supported by DPDK is listed here: http://dpdk.org/doc/nics

10.5.2. Configure “Port Forwarding” to enable SSH from host to guest.

  • Select “Network” -> “Adapter 1”

  • Click “Advanced: Port Forwarding”

    _images/virtualbox-010.png
  • Click “+” mark on right. Set below to newly created row.

    • Name: rule_name you like. ex: ssh
    • Host Port: port used on Host OS. ex: 2201
    • Guest Port: 22 (SSH)

10.6. VM Processor (CPU) Setting

  • Select “System” -> Processor” to modify CPU cores to be assigned to the VM.

  • 2 or more CPU cores are required when using DPDK.

    _images/virtualbox-014.png

10.7. Install Guest OS (Linux / Ubuntu)

  • Download Guest OS ISO:

  • Start VM by clicking “Start”

    _images/virtualbox-012.png
  • At “Select start-up disk” diaglog, select ISO you just downloaded and click “Start”

    _images/virtualbox-013.png
  • Follow Ubuntu install wizard. A few points to be noted are:

    • Select Primary Network Interface: eth0 (Adapter 1)
    • No automatic updates (for testing purpose to make package predictable)
    • Software installation: OpenSSH server

Once installed, SSH to localhost:<port> where <port> is the “Host port” you configured in “Port Forwarding”.

10.8. Next Steps

Follow steps in Installation with raw-socket configuration or Installation with DPDK to continue Lagopus software switch and configuration.