Installation
Hystck is a framework that consists of two distinct parts as we described in the architecture section. For that reason it is mandatory to install hystck on both, the host and the guest system. In the next sections we will show how that installation can be done.
Once you have finished the installation process, visit the first run section for some help on getting started with hystck.
It is recommended to install the service VM before you install the guest components.
In case you want to use the automated installation scripts for either the host or the guest machines, it is recommended to read the config file page and make adjustments if necessary before proceeding with the installation.
Here we will describe how to install the host part of hystck on a physical machine.
For this Ubuntu 19.10 is the recommended OS. Other Ubuntu distributions will work as well, but the automatic setup script might need some alterations depending on your distribution.
In-depth instructions can be found here.
Here we will describe how to install the guest part of hystck on a virtual machine as well as creating said virtual machine with everything needed for hystck to operate correctly.
An in-depth installation manual for both Windows and Ubuntu can be found here.
Setup the virtual machine and install Windows like you normally would (or use our prepared script win10install.sh in install_tools). After that follow the simple steps in the list below.
- Download hystck source code inside VM
- extract hystck source code to a folder on the Desktop of your virtual machine
- open the folder hystck/install
- start install.bat
In-depth instructions can be found here.
Setup the virtual machine and install Ubuntu like you normally would (or use our prepared script ubuntu19.10.sh in install_tools). After that follow the simple steps in the list below.
- Download hystck source code inside VM
- extract hystck source code to a folder on the Desktop of your virtual machine
- open the folder hystck/install
- start linux_installation.sh
In-depth instructions can be found here.
Here we will describe how to install the Service VM containing third party services that enhance hystck's capabilities such as a DHCP server as well as services needed for specific scenarios.
Instructions can be found here.
After the successful installation of the hystck framework you should test that everything works as expected. Run python examples/testrun2.py firefox thunderbird veracrypt. This calls a testing script that tests all functions of the applications provided as parameters. If this script runs without errors all applications and prerequisites are installed correctly. The next step will be implementing your own scenarios or using the generator.