This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
Installation
This is the installation guide for testing the adaptive game. It shows how to install the components needed for the testing itself, and how to check if they are present and correctly installed.
Requirements
Hardware:
- CPU that supports virtualization
- 4 GB of RAM (More is preferred)
- 40 GB of free space
Programs:
- Python (>= 3.7)
python --version - pip for python
pip -V - VirtualBox (>= 6.0)
vboxmanage --version - Vagrant (>= 2.2.5)
vagrant --version
Enabling virtualization in BIOS
The first step you need to do, no matter your operating system, is to have virtualization enabled in BIOS. The exact steps differ depending on your computer hardware. Here are a few guides that cover how to do it in detail:
- How to Enable Intel VT-X & AMD Virtualization on PC - Steps taken in Enable Intel VT-X Virtualization on PC.
- Enabling Intel VT and AMD-V virtualization hardware extensions in BIOS - Steps 1-5.
- How to enable Virtualization Technology on Lenovo PC computers - Steps 1-4.
Generally speaking, the steps are to enter your computer's BIOS by pressing a key like F10. (The boot screen should say which key that is.)
Then, in BIOS, you look for virtualization options, which should be somewhere in "Security" or "Advanced configuration" or "Advanced processor settings".
Changing this setting should not affect performance or anything too much -- it just allows your computer to simulate virtual machines like the ones used in the adaptive game. When you are done with playing the game, you can turn the setting off if you wish. ## Installation
Debian based Linux
Debian distributions should come with the latest version of Python by default.
You might still need to download the python-pip package.
- Enable virtualization in BIOS (see above).
- Install VirtualBox.
- Install Vagrant.
Arch Linux
- Enable virtualization in BIOS (see above).
- If you don't have python installed,
sudo pacman -S python. If you have a custom python installation, or if you have multiple versions of python installed, make sure thatpythoncalls Python version 3.5 or higher. (You can check withpython --version) - Install pip for python.
sudo pacman -S python-pip - Install VirtualBox.
sudo pacman -S virtualbox. Forlinuxkernel, choose providervirtualbox-host-modules-arch, for any other kernel (likelinux-lts), choosevirtualbox-host-dkms - Install Vagrant.
sudo pacman -S vagrant
Windows 10
- Enable virtualization in BIOS (see above).
- If you don't have Python, install it from here. By default, the installer should install pip as well. You should also check
Add Python to PATH, so you can run pip and python from anywhere (including the project's folder). If you have a custom Python installation, double check that you have the right version, and that pip is installed. - Install VirtualBox. (VirtualBox 6.1.X platform packages -> Windows hosts)
- Install Vagrant.
- Ensure Hyper-V is disabled. (Programs and Features > Turn Windows features on or off > Hyper-V.)
If you're on Windows Home edition, you don't need to disable Hyper-V, because Windows Home doesn't have Hyper-V.
Downloading the project
Once you have all the prerequisites installed, you download the project. (You clone the assistant repository, and download the game.)
Finalization
If everything works as should, you should run those commands in the project directory.:
pip install -r python-requirements.txt(This installs python packages required to run the assistant.)
Sometimes, you might also be asked to download the biggest virtual machine in advance for example:
vagrant box add munikypo/kali-2019.4
Furthemore, running python assistant.py (or ./assisstant.py) in the assistant directory should open up an interactive command line tool for running the game. If you type c or check into it, it should check if all tools are installed, and if they are on the correct version.
If you are on Windows, you should run the assistant as administrator.
NOTE: On Windows, the assistant will not find VirtualBox even if you have it. That's fine.
[lili@lili-pc assistant]$ python assistant.py
Welcome to the adaptive game assistant.
Basic commands are:
(S)tart, (N)ext, (H)elp, (C)heck, (E)xit
Waiting for your input:
check
checking Python version:
OK, Python version higher than 3.7.
checking Vagrant version:
OK, Vagrant version higher than 2.2.
checking Virtualbox version:
OK, VirtualBox version higher than 5 detected.
You can type exit to exit the assistant afterwards.
If you installed all of the tools, and the assistant is working fine, then you are done with the installation.