VirtualBox VM Setup
Docker Desktop Licensing
As of Jan 31, 2022, a paid license is required for most Windows users to run Docker Desktop.
Docker Desktop is a third-party Windows program used to run the containerized software packages, such as GridAPPS-D.
Personal, small business, and education may still be permitted under ther free personal license of docker (referenced in these instructions).
For more information, see Docker Pricing & Licensing FAQ
VirtualBox VM
A VirtualBox installation provides an option for running GridAPPS-D on Windows machines without a Docker Desktop license.
Installation Steps:
System Requirements
OS:
Windows 10, Version 2004 or higher, with Build 19041 or higher
RAM:
8GB (absolute minimum for 13 and 123 node models, may encounter memory overload during installation );
16GB (preferred for small models, minimum for 8500/9500 node models);
32GB (recommended for application development)
Disk Space:
15GB required for installation
Note: The download size is quite large, so it is recommended to use a fiber or ethernet interent connection, rathered than a metered hotspot to avoid excessive data usage charges.
Download VirtualBox
Download the latest version from the VirtualBox website
Run the .exe file after the download is complete.
Continue with all default options to install VirtualBox
After the installation wizard has finished, select “Start Orace VM Virtualbox after installation” and click “Finish”
Download Ubuntu Linux OS
Download Ubuntu 20.04.03 from the OSBoxes.org website
Alternatively, you can download the installer directly from the associated SourceForge link
You will need 7-Zip to unzip the download file. You can download and install the tool from the 7-Zip Website
After the download is complete, right-click on the zipped download and unzip the Ubuntu OS file in a directory where you can easily find it.
Create an Ubuntu VM
Return to VirtualBox and click New
to create a new virtual machine.
Enter Ubuntu
in the space for Name:
. VirtualBox should automatically populate the remaining forms in the window. Click Next to continue.
It is recommended to select at least 8 GB of RAM for the VM instance.
Select Use an existing virtual disk file
and click on the folder icon
Click “Add” to add the downloaded disk image for Ubuntu 20.04.3 that you unzipped previously.
Then click Choose
and Create
to create the new virtual machine.
Configure the Ubuntu VM
Click the Settings
icon to configure the VM.
Next, select System
from the left menu and then the Processor
tab.
It is recommended to allocate 4 CPU cores to GridAPPS-D (2 at minimum)
Next, select Display
from the left menu. Increase the Video Memory
to at least 32 MB.
Check the Acceleration
box to enable 3D acceleration of graphics windows.
Click OK
to save the settings. Then, start the VM by right-clicking on the VM instance and selecting Normal Start
After the VM has launched, login with the default username and password: * username: osboxes.org * password: osboxes.org
Enable clipboard sharing for copy-paste capability between your windows and virtualbox environments.
Click the Devices
menu and select Insert Guest Additions CD image ...
and follow the prompts to load missing components.
After all modules are built, open a new terminal and reboot the VM using sudo reboot
Finally, update all modules and install git and pip by running
sudo apt-get install update
sudo apt-get install git
sudo apt-get install pip