Worker setup on Windows

Multi Variant Fishtest: worker setup on Windows

Windows Subsystem for Linux

If you know Linux and you have a supported Windows platform, you can run the worker:

• enabling Windows Subsystem for Linux (suggested Ubuntu 20.04), and
• simply following the Worker setup on Linux

If you are not a Linux user use the following instructions.

Get username/password for Multi Variant Fishtest

Create an account on Multi Variant Fishtest choosing an username/password:

http://www.variantfishtest.org:6543/signup

Setup Fishtest

Download Fishtest directly from Github and unzip the archive:

https://github.com/ianfab/fishtest/archive/master.zip

MinGW-w64 & MSYS2 install

MSYS2 is a collection of GNU utilities, based on modern Cygwin (POSIX compatibility layer) that uses pacman (from Arch Linux) as packages manager to install and to update packages. MinGW-w64 is a project created to support the GCC compiler on Windows systems.

MSYS2 provides 3 different shells:

• MSYS2 MinGW 64-bit, used to build 64 bit applications. Use this shell
• MSYS2 MinGW 32-bit, used to build 32 bit applications
• MSYS2 MSYS, used to build MSYS2 core packages

The default setting installs MSYS2 in to C:\msys64 folder, the user home is the folder C:\msys64\home<your_username>

Warning: MSYS2 requires Windows 7 64 bit or later.

1. download and install MSYS2, and follow the official instruction to update the MSYS2 packages (simply: a. update the core packages executing pacman -Syuu, when requested close the windows pushing the top right X button b. open a MSYS2 MinGW 64-bit shell and update the others packages executing pacman -Syuu)

2. install the required packages:

• in a MSYS2 MinGW 64-bit shell run:

pacman -S make mingw-w64-x86_64-gcc mingw-w64-x86_64-python3

Launching the worker

1. in fishtest-master/worker directory, create a text file named fishtest.cmd withe the text below (write the <n_cores> that you want dedicate to fishtest, and your fishtest's <username> and <password>)

@echo off
set PATH=C:\msys64\mingw64\bin;C:\msys64\usr\bin;%PATH%
set VENV=C:\fishtest-master\worker\env

if not exist %VENV% (
  python3.exe -m venv %VENV%
  %VENV%\bin\python3.exe -m pip install --upgrade pip setuptools wheel requests
)
%VENV%\bin\python3.exe -i C:\fishtest-master\worker\worker.py --concurrency <n_cores> <username> <password>

2. start the worker executing fishtest.cmd (e.g. double click on fishtest.cmd)