What is WSL
The Windows Subsystem for Linux, or WSL, is an optional feature available on Windows 10 that allows Linux programs to run natively on Windows (in a Windows 10 version of the Bash shell). WSL was designed by Microsoft in partnership with Canonical, the creators of Ubuntu. Together, they created a kernel compatibility layer based on Ubuntu. To run WSL you need Windows 10 64-bit version 1607 (the Anniversary update) or above (32-bit versions are not supported). You can check your Windows version here.
Why Dragonfly with WSL
Using WSL is different from installing a virtual machine (with VMware or Virtual Box), as with WSL the Linux system runs natively on Windows. There is no third party involved and this means that the level of performances is much higher than when using a virtual machine. Despite this it must be said that even with WSL the performances are about 20% slower than a native Ubuntu installation.
Step 1 – Enable WSL in Windows 10
- Open PowerShell as Administrator and run:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
- Restart your computer when prompted.
Step 2 – Install Ubuntu inside WSL
Click the following link to automatically install the current Ubuntu LTS release from the Microsoft store: Ubuntu 18.04 LTS (Bionic).
Step 3 – Install Dragonfly
- Launch the Ubuntu Terminal via one of the following methods:
- Searching for UBUNTU inside the Windows Start menu
- or from the Windows command line using the wsl command.
- or from the Windows command line launching the command: ubuntu1804
- Install Unzip with this command:
sudo apt install unzip
- Close the Ubuntu Terminal and launch it again.
- Download the latest version of Dragonfly with this command:
- Launch these commands to install Dragonfly:
unzip dragonfly_installation_linux_20200316.zip cd dragonfly_linux ./install.sh # At this stage, you will be asked for superuser credentials for installation. The installation of the Dragonfly Java App, Web UI and all the dependencies could take a bit. Be patient.
Step 4 – Launch Dragonfly
- Go the directory where the
start.shscript is located (
cd dragonfly_linux/application/) and enter the following command to launch the Dragonfly Java App:
# Replace 'my_site_id', 'my_email' and 'my_password' with Accuware credentials (quotes must remain) java -jar -DsiteId="my_site_id" -Dlogin="my_email" -Dpassword="my_password" dfja-1.6-dist.jar
- Open a tab inside your favorite browser and type the following URL to launch the Dragonfly Web UI:
- You have now to configure Dragonfly following the instructions inside this page.