This guide will walk you through setting up an Ubuntu 18.04.4 virtual machine on Virtual Box.
Please note before you get started that you will need at least 200GB of free drive space. It's also highly recommended that your drive be an SSD for the best performance (although it will work just fine if installed on a disk drive).
Give it a name and select your downloaded .iso file 
Click next and fill out the unattended guest OS setup 
Click next and give it 4096MB (or more) RAM and 2 processors 
> Note: If you can, we suggest to give it much more RAM. It depends on your system's capabilities.
> Note: We were experiencing strange stuttering of the VM when the processor count wasn't set to 2, so probably best to keep it at 2. Your results may vary.
Click next and give it at least **200 GB** of hard disk space 
> Petalinux and Vivado/Vitis require a LOT of drive space. We don't suggest going below that for your drive.
Here is my final configuration screen. Make sure your values are similar. 
Click finish.
# Set up the VM
Start your VM if it hasn't already. You should be greeted with an install screen. It should install and configure your OS for you (unattended). 
To get auto screen resizing and native clipboard support, install the VBox_GAs. Navigate to devices -> Insert Guest Additions CD Image in Virtualbox, and click Run when it appears on the Ubuntu desktop.
comment out the last three lines of '/etc/apt/apt.conf.d/50appstream' like so
__**If you ran into this error, you do need to re-run the above update commands as the update did not properly finish!**__
## Configure your ARP table to resolve the CyDAQ's IP address to the correct interface.
```bash
sudo apt install net-tools
```
Ping the CyDAQ and wait for it to time out (this step is needed to populate the arp table)
```bash
ping 169.254.7.2
```
> Note: You will need to ctrl + c to stop the ping once you see a few error messages
```bash
sudo arp -s 169.254.7.2 <mac address from earlier>
```
For example, mine was
```bash
sudo arp -s 169.254.7.2 08:00:27:4c:ec:f2
```
To verify that it's working correctly, connect a CyDAQ to your PC (with the correct firmware installed) and ping it.
```bash
ping 169.254.7.2
```
**Note**: if it is not working (a.k.a. not returning a ping from 169.254.7.2).
1. Open up the device manager.
2. Unplug your cords and plug them back in noting what USB Serial Devices and Ports disappeared and came back. (There should be 2)
3. Disable and Enable the devices.
This should have allowed your VM to pick them up instead of your windows machine. If not keep trying until it does and cry.
## Next steps
You are now ready to install [Vivado/Vitis](https://git.ece.iastate.edu/sd/sdmay23-47/-/wikis/Vivado-and-Vitis-Install) and [Petalinux tools](https://git.ece.iastate.edu/sd/sdmay23-47/-/wikis/Petalinux-Tools-Install)!
