Skip to content

Running the worker on Windows

ppigazzini edited this page Apr 16, 2024 · 100 revisions

Read Running the worker before installing the worker.

Windows Subsystem for Linux

If you are a Linux user with a supported Windows platform, you can run the worker by:

MSYS2

MSYS2 is a software distribution and building platform for Windows. It provides a Unix-like environment, a command line interface, and a software repository, making it easy to install software on Windows or build software on Windows with the GCC compiler. The first setup may take between 8-20 minutes depending on your download bandwidth.

Windows 11/10 instructions with winget

The setup installs MSYS2 in C:\msys64 using winget, the Microsoft Windows package manager already installed on up-to-date Windows 11/10.

Installation instructions

  1. Download and unzip the winget - fishtest worker setup archive
  2. Right click on 00_install_winget_msys2_admin.cmd and select Run as administrator
  3. Double click on 02_install_worker.cmd and write when asked: your fishtest username, your fishtest password, the number of CPU cores to be contributed
  4. Enter the newly created "worker" folder and double click on fishtest.cmd to start the fishtest worker. You can move the "worker" folder in your preferred place, you can rename the folder e.g. "worker_3_cores" and redo the point 3 to setup a new worker with a different number of cores
  5. from time to time (suggested monthly) update the MSYS2 packages:
    1. Download the up to date winget - fishtest worker setup archive
    2. Stop the worker
    3. Double click on 04_update_msys2.cmd. This requires a couple of minutes in a system updated regularly. Execute the script twice: the first run updates the core packages, the second one the applications packages.
    4. Start the worker

Uninstall the worker, MSYS2

  1. Delete the worker folder
  2. Uninstall MSYS2 with Installed Apps (Windows 11) or Apps and features (Windows 10)
  3. Delete the C:\msys64 folder

Windows 11/10/8 instructions with Chocolatey

The setup installs Chocolatey, a third-party Windows package manager, and MSYS2 in C:\tools\msys64 using Chocolatey. If you have already installed MSYS2 in another folder, please uninstall it: the scripts are expecting to have MSYS2 installed in C:\tools\msys64

Installation instructions

  1. Download and unzip the choco - fishtest worker setup archive
  2. Right click on 00_install_choco_msys2_admin.cmd and select Run as administrator
  3. Double click on 02_install_worker.cmd and write when asked: your fishtest username, your fishtest password, the number of CPU cores to be contributed
  4. Enter the newly created "worker" folder and double click on fishtest.cmd to start the fishtest worker. You can move the "worker" folder in your preferred place, you can rename the folder e.g. "worker_3_cores" and redo the point 3 to setup a new worker with a different number of cores
  5. from time to time (suggested monthly) update Chocolatey and the MSYS2 packages:
    1. Download the up to date choco - fishtest worker setup archive
    2. Stop the worker
    3. Right click on 04_update_msys2_choco_admin.cmd, select Run as administrator, and click approve if requested. This requires a couple of minutes in a system updated regularly
    4. Start the worker

This video provides a tutorial on how to setup the worker on Windows 10.

Uninstall the worker, MSYS2 and Chocolatey

  1. Delete the worker folder
  2. Delete the C:\tools\msys64 folder
  3. Delete the C:\ProgramData\chocolatey folder
  4. Optional: delete the Chocolatey variables according to the official uninstallation instruction

Windows 7 instructions

Update Windows 7 with the latest Service Pack. MSYS2 must be manually installed and updated.

Installation instructions

  1. Download and unzip the choco - fishtest worker setup archive
  2. Download and start the one-click installer for MSYS2, change the installation folder to C:\tools\msys64
  3. Double click on 02_install_worker.cmd. You will be prompted to provide your fishtest username, your fishtest password, the number of CPU cores to contribute
  4. Navigate to your newly created "worker" folder and double click on fishtest.cmd to start the fishtest worker. You can move the "worker" folder to your preferred destination, you can rename the folder e.g. "worker_3_cores" and redo point 3 to setup a new worker with a different number of CPU cores
  5. from time to time (suggested monthly) update the MSYS2 packages:
    1. Stop the worker
    2. Double click on C:\tools\msys64\mingw64.exe
    3. Execute the command pacman -Syuu --noconfirm
    4. if asked to restart MSYS2 system: close the mingw64 window and repeat the previous 2 steps
    5. Start the worker

Uninstall the worker and MSYS2

  1. Delete the worker folder
  2. Uninstall "MSYS2" from the Control Panel
  3. Delete the C:\msys64 folder