Overview

The Windows Subsystem for Linux (WSL) is a compatibility layer that allows to run Linux applications directly on Windows 10 and Windows Server 2019. By installing WSL, SeqSphere+ users can benefit from Linux based applications that are distributed together with SeqSphere+ (e.g., SKESA assembler and Mash). If WSL has been installed successfully, those features are shown automatically in the SeqSphere+ pipeline script settings and tools menu.

Installing Windows Subsystem for Linux

For downloading and installation of Windows Subsystem for Linux on Windows 10 (v.1809) simply follow these steps:

Windows Features Menu
  • Step 1: Enable the Windows Subsystem for Linux feature. Button16 Important.png Important: This step needs administrative privileges.
  1. Right-click on the Windows Start menu icon, choose Search and type "Windows Features". Select the top entry (category Control panel) to enable or turn off Windows-Features. The Windows-Features dialog will be opened.
  2. Select in the upcoming dialog the check box for Windows Subsystem for Linux from the bottom of the list and press the OK button. Applying the changes may take a few minutes. Finally, press the Restart now button to reboot the computer.
  • Step 2: Install the Linux distribution (requires no administrative privileges and will only be installed for the logged-in user only)
  1. Open the Start menu and select Microsoft Store.
  2. Search for Ubuntu.
  3. Select Ubuntu 18.04 LTS among the list of presented apps, then click the Install (or Get) button to download this Ubuntu Linux distribution.
  4. If a Microsoft Sign in dialog opens (without a user name), it is not necessary to sign in. Just close the dialog with the upper right window button and the installation continues. If instead a Microsoft dialog appears asking for password of your specific Microsoft account, you need to enter your password to continue with the installation.
  5. After the download has finished press the Launch button to install and initialize the WSL. A Linux terminal window is opened. After some minutes, the message "Enter new UNIX username" is shown. Type a user name and press the Return key. Next a message "Enter new UNIX password" is shown. Type a password (no characters are shown while typing) and press the Return key. Then, a message "Retype new UNIX password" is shown. Type the password again and press the Return key. The credentials should be memorized as they are needed to install Linux software other than those supplied with SeqSphere+.
  6. Finally, close the Linux terminal window.

Doc-info.pngHint: For installing WSL on Windows Server 2019 please follow the Microsoft installation guide.