GrandReChallenge

Instructions

If you do not wish to participate in this study, please close this page. If you consent to all terms on this page, enter your event token here:

Select your device type:

Debian-based Virtual Machine Debian-based Raspberry PI Fedora-based Virtual Machine(Broken at the moment) Windows-based Virtual Machine(Beta)

Download Installer

Then, follow the following instructions to install the data collection software:

1. Download and install a virtual machine player/hypervisor for your device if you are running a virtual machine. We recommend either VMWare or VirtualBox; select an appropriate option for your operating system. If you are not familiar with virtual machine technology, please do some research before continuing. A good introduction to virtual machines can be found here.
2. Download and install a virtual machine or install your OS if using a physical device. This software has been tested on Ubuntu, Kali, and 32 bit Raspbian Linux, but may work on other versions of Linux. Debian based distributions with apt running X11 (not Wayland distros) should work. With Linux, X86 and X64 architectures work. ARM 32 bit works, but ARM 64 does not yet. Windows support is currently in beta testing but should work on Windows 10. We recommend Kali Linux for security competitions, as it has handy tools for these problems.
3. If you are using a Windows virtual machine, download and install the latest version of Java. We use the Oracle JDK but other virtual machines may also work. Windows support is currently in beta testing, so please keep in contact with the study admins when using it to ensure data is being uploaded correctly.
4. On your virtual device, navigate back to this page and make sure your token is entered in the field above. Press the "Set" button once you have entered your token. This button updates the download links.
5. Download the installer script.
6. Enable execution of the script. How to do this is operating system specific. On most Linux distributions, you can do this by right clicking the file in the file system interface, select "properties" or something similar, and find an execution option under "permissions" or with the "chmod" command.
7. Install the data collection software by opening a terminal in the folder with the script (on Linux, this can be done by right clicking in the folder and selecting "open terminal" and on Windows this can be done by searching for "cmd" on the start menu, right clicking, and selecting "Run as Administrator" before navigating to the appopriate folder) and running the installer:
   For Linux:
   sudo ./install_data_collection.sh
For Windows:
./install_data_collection.bat
8. This installation step might take a few minutes and will restart your device.
9. Use this virtual machine to participate in the competition—have fun!

How to Stop Data Collection

If you wish to stop your participation at any point, follow the instructions below. If you would like to have your data collected thus far removed as well, contact the system admins, listed below.

1. On your virtual machine, download this script.
2. Enable execution of the downloaded script.
3. Open a terminal in the folder with the downloaded script and enter the following:
   sudo ./stopDataCollection.sh.sh
4. This script will restart your computer when you run it to complete the uninstallation.
5. Note that this script leaves a few pieces of software that come with the data collection software installed so that, if you are running other software using these installations, that other software will not fail. In particular, the default Java JDK, tomcat8, and mariadb are left installed, but have their data collection components removed. These pieces of software can be removed by using the apt-get remove command.

Who should I contact with questions and/or concerns about the study?