Skip to content

Deploy Enterprise-Edition on WSL2

WSL2

This tutorial explains how to setup the entire OctoPerf Enterprise-Edition platform using Windows Subsystem for Linux.

The Windows Subsystem for Linux (WSL) is a solution that allows running a Linux environment directly on Windows, using a terminal, with no third party Virtual Machine solution is required.

We're going to use its latest version, WSL2, which goes further beyond in terms of integration and simplicity.

Prerequisites

This tutorial requires:

  • Windows 10 or Windows Server 2019 (version 1709 or greater),
  • Basic knowledge of Microsoft Windows,
  • Basic knowledge of Linux,
  • And basic knowledge of how Docker works.

Installing WSL2

First, we need to activate WSL2 on your Windows machine. Open a PowerShell terminal in Administrator mode:

Powershell1

Enter the following command to enable WSL 1 :

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all

Powershell2

Reboot your machine. Open PowerShell in admin mode again, and type the following command to enable WSL2:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all

Powershell3

Reboot your machine again.

You now have WSL2 installed on your machine.

Installing Ubuntu

We are now ready to install Ubuntu on your Windows machine. Open the Microsoft Store to download and install Ubuntu:

storeubuntu

Open a PowerShell terminal in admin mode, and set WSL2 as the default option:

wsl --set-default-version 2

To check if your linux distribution is indeed using WSL2, type the following command:

wsl --list --verbose

Powershell4

If it's not the case, enter this command to correct the configuration:

wsl --set-version Ubuntu 2

You now have Ubuntu on your Windows Server, it can be launched directly from the Windows Start Menu, like any other program.

Installing Docker-CE on Ubuntu

After launching Ubuntu, see documentation explaining how to install docker-ce on Ubuntu.

You can now start docker, with the following command:

sudo service docker start

You can access your local Windows drives directly from Ubuntu, by accessing the following directory:

cd /mnt/

Install the Enterprise Edition

The next steps are similar to a classic Enterprise Edition install on Unix, so please refer to our documentation on the subject: