-
Notifications
You must be signed in to change notification settings - Fork 6
Installation
ForTrace is a framework that consists of two distinct parts as we described in the architecture section. For that reason it is mandatory to install ForTrace 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 ForTrace.
It is recommended to install the service VM before you install the guest components.
Note: The user management module requires additional installations for some functions that are not automated in the current installation scripts. The following needs to be done to use this module:
- Set up fortrace according to the installation guide found in the documentation
- create new folder /contrib/veracrypt and copy the veracrypt files of a portable version to it
- create a new folder /contrib/windows utils and copy the executable of the tools SDelete (sdelete64.exe) and PSExec
(PsExec64.exe) to it (can be downloaded for free on official Microsoft websites)
More information can currently be found in examples/Thesis_Windows/HowTo.txt.
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 ForTrace on a physical machine.
Ubuntu 22.04 is the recommended OS. Other Ubuntu distributions, especially older 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 ForTrace on a virtual machine as well as creating said virtual machine with everything needed for ForTrace 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 ForTrace source code inside VM
- extract ForTrace source code to a folder on the Desktop of your virtual machine
- open the folder ForTrace/install
- start install.bat
In-depth instructions can be found here.
The install script is still be named after Ubuntu 19.10, but is also compatible with other versions of Ubuntu.
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 ForTrace source code inside VM
- extract ForTrace source code to a folder on the Desktop of your virtual machine
- open the folder fortrace/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 ForTrace'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 ForTrace 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. Additional module tests can be found in examples/ModuleTests.