Guide for the installation of TradEval

We use a Docker container to run TradEval on Windows, Mac OS and Ubuntu.
We will use a Windows X Server which will depend on the OS.

1. Docker installation and configuration

First you need to install Docker.

Windows

• Download Docker at https://docs.docker.com/docker-for-windows/install/

Mac OS

• Dowload Docker at https://docs.docker.com/docker-for-mac/install/

Ubuntu

• Dowload Docker at https://docs.docker.com/engine/install/ubuntu/
  
  
• Install it
• Run Docker

2. Installation and running of the Windows X Server

Windows

On Windows, we use the server vcxsrv by running XLaunch.

• Download the executable of vcxsrv at https://sourceforge.net/projects/vcxsrv/
  
• Accept the default configuration and install
  
• Then run XLaunch from the start menu.
  
• Choose the option "Multiple Windows" and click on Next
  
• Choose the option "Start no client" and click on Next
  
• Don't change any parameter and click on Next
  
• (Optionnal: save the configuration for later running)
  
• Click on Finish
  

Mac OS

On Mac OS, we use the server XQuartz:

• Download the Disk Image file at https://www.xquartz.org/
• Run the installer by double-clicking on the file you dowloaded
• Accept the licence agreement, click on Install
• Once the installation is done, log out from your session and log back in

Ubuntu

On Ubuntu, we use xauth:

• Install xauth: sudo apt-get install xauth

3. Running TradEval with Docker

Ubuntu

Once the X Server is installed and configured, you need to enter the following commands in a terminal.

First, pull the image of the project:
sudo docker pull pritie/tradeval2
Then enter:
xauth list The output correspond to a cookie for the session on which the X server is currently running.
Copy the output, you will need it later

Now run the container :
sudo docker run -ti --net=host -e DISPLAY -v /home:/path_host pritie/tradeval2 bash
You now have to connect to xauth by entering: xauth add COOKIE
with COOKIE the output of the previous command "xauth list" entered on the host.

You can know execute the python script: python3 /home/TradEval/tradEval.py

Windows / Mac OS

Be sure the X Server is launched (run Xlaunch on Windows, XQuartz on Mac).
Open a terminal.
First, pull the image of the project:
sudo docker pull pritie/tradeval2
Then enter: docker run -ti --rm -e DISPLAY=IP_ADDRESS:0.0 -v /:/path_host tradeval2
with IP_ADRESS corresponding to your IP adress. You can find it by typing the command ipconfig (windows/mac os) or ifconfig (ubuntu) on a terminal.

You can know execute the python script: python3 /home/TradEval/tradEval.py

Note that when you choose a file in tradEval, you can find a file of your host machine in the repository /path_host
This repository will give you access to the home repository of your host machine.