1.1.1.1 Prepare virtual environment - Daniel-Brosnan-Blazquez/vboa GitHub Wiki

Introduction

This procedure covers the action to prepare the virtual environment for developing BOA.

Pre-conditions

  1. VirtualBox is installed

Tested configurations

  1. Ubuntu 20.04 (64 bits)

Procedure

  1. Create new virtual machine for hosting Ubuntu (64 bits):

    1. Set the following parameters:

    • Name: BOA

    • Type: Linux

    • Version: Ubuntu (64-bit)

    image

    1. Set the Memory size as 4GB:

    image

    1. Create a hard disk of 40GB:

    image

    image

    image

    image

    1. Final configuration should look like this:

    image

  2. Install operating system:

    1. Download the preferred operating system (default Ubuntu 20.04):
    2. Double click on the virtual machine just created:

    image

    1. Find the ISO image of the operating system:

    image

    image

    1. Follow specific instructions related to the selected operating system to install it (create a specific user, for example, boa).
    2. Once the operating system is installed, power off the guest operating system and increase the number of associated CPUs if possible (4 maximum):
    3. Select the virtual machine
    4. Click on settings

    image

    1. Click on System → Processor and increase the number of CPUs:

    image

    1. Set the RAM to 8 GB:

    2. Select the virtual machine

    3. Click on settings

    image

    1. Click on System → Motherboard and set the Base Memory to 8192 MB:

    image

  3. Install Guest Additions CD image:

    1. Start virtual machine
    2. Execute the following commands (Instructions for Ubuntu 20.04):
sudo apt update
sudo apt upgrade
sudo apt install build-essential dkms linux-headers-$(uname -r)

1. Click on Devices → Install Guest Additions CD image... 



![image](https://github.com/user-attachments/assets/d8345532-6634-4fc7-a620-8b0c7234e03d)



If you have your virtual machine window in a scale mode you are not going to see the options buttons above, therefore yo will have to return to the nominal display mode.

To do this use the key combination:  **Host key ("right control" by default) + C** If your keyboard does not have this "right control" key, then you will have to choose another Host key:
1. Inside your VirtualBox Manager go to:  **File → Preferences** 
![image](https://github.com/user-attachments/assets/671166c6-eaa1-4c3c-9aad-89a755c919dc)
1. Then go to:  **Input → Virtual Machine →  Change your shortcut for Host Key Combination**   **→ OK**

image

1. Click on RUN (Instructions for Ubuntu 20.04):

![image](https://github.com/user-attachments/assets/a4aa3c2d-e230-49e2-8692-adc874eb82e1)

Check that the service is running with the following command:

ps faux|grep -i vbox

Which should show a similar result to the following one:

root 1427 0.0 0.0 238184 2772 ? Sl 12:55 0:00 /usr/sbin/VBoxService --pidfile /var/run/vboxadd-service.sh

  1. Configure VirtualBox Network to Bridged Adapter to be able to use the app on the host browser:

    image

    If you have more than one network interface, choose the right one to connect the bridge in the "Name" dropdown menu.

    Now, instead of using localhost, use the IP of your guest to access the app through the host browser. To know the IP use the following command:

hostname -I | awk '{print $1}'

  1. Configure as "Bidirectional" the Shared Clipboard and Drag'n'Drop options:

    image

  2. Restart the virtual machine and, now, the virtual environment for development should be ready to use.

Note for Ubuntu 20.04: if the window does not fit all the screen, modify the display settings (tested 1680 x 1050):

image