====== 1.2 WSL2 einrichten ======

Diese Anleitung zeigt, wie Sie das Windows Subsystem for Linux (WSL2) installieren.

----

===== Was ist WSL? =====

**WSL** (Windows Subsystem for Linux) ermöglicht es, Linux direkt in Windows auszuführen:
  * Vollständige Linux-Umgebung
  * Zugriff auf Windows-Dateien unter ''/mnt/c/'', ''/mnt/d/'' etc.
  * Ideal für Linux-Builds und Docker

<WRAP info>
**Wofür brauchen wir WSL?**

  * Linux-Build von OpenSSL
  * WASM-Build mit Emscripten
  * Docker-Entwicklung
</WRAP>

----

===== Schnell-Installation =====

<code powershell>
# Als Administrator in PowerShell:
wsl --install -d Ubuntu-22.04
</code>

Das installiert:
  * WSL2-Komponenten
  * Ubuntu 22.04 LTS
  * Linux-Kernel

<WRAP important>
Nach der Installation: **Computer neu starten!**
</WRAP>

----

===== Schritt-für-Schritt =====

==== 1. WSL aktivieren ====

<code powershell>
# WSL und Virtual Machine Platform aktivieren
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
</code>

==== 2. Neustart ====

Computer neu starten.

==== 3. WSL2 als Standard setzen ====

<code powershell>
wsl --set-default-version 2
</code>

==== 4. Linux-Distribution installieren ====

**Ubuntu (empfohlen):**
<code powershell>
wsl --install -d Ubuntu-22.04
</code>

**Fedora (Alternative):**
<code powershell>
# Fedora manuell aus dem Microsoft Store oder:
winget install WhitewaterFoundry.Fedora.39.WSL
</code>

==== 5. Benutzer einrichten ====

Beim ersten Start fragt Ubuntu nach:
  * Benutzername (z.B. ''dev'')
  * Passwort

----

===== Build-Tools installieren =====

Nach der WSL-Installation müssen Build-Tools installiert werden:

==== Ubuntu ====

<code bash>
# WSL öffnen
wsl

# System aktualisieren
sudo apt update && sudo apt upgrade -y

# Build-Tools installieren
sudo apt install -y \
    build-essential \
    perl \
    nasm \
    git \
    cmake \
    pkg-config
</code>

==== Fedora ====

<code bash>
# WSL öffnen
wsl

# Build-Tools installieren
sudo dnf install -y \
    gcc \
    gcc-c++ \
    make \
    perl \
    nasm \
    git \
    cmake
</code>

----

===== Prüfung =====

<code bash>
# Compiler prüfen
gcc --version
# Sollte zeigen: gcc (Ubuntu 11.x.x) ...

# Perl prüfen
perl -v
# Sollte zeigen: This is perl 5...

# NASM prüfen
nasm -v
# Sollte zeigen: NASM version 2.x
</code>

----

===== Dateizugriff =====

==== Windows-Dateien von WSL ====

Alle Windows-Laufwerke sind gemountet:

<code bash>
# C: Laufwerk
ls /mnt/c/

# D: Laufwerk (unsere Projekte)
ls /mnt/d/Projects/openssl-3.6.0/
</code>

==== WSL-Dateien von Windows ====

<code>
\\wsl$\Ubuntu-22.04\home\<benutzer>\
</code>

Im Explorer: ''\\wsl$'' in die Adressleiste eingeben.

----

===== Performance-Tipps =====

<WRAP tip>
**Dateien im Linux-Dateisystem sind schneller!**
</WRAP>

| Speicherort | Performance |
|-------------|-------------|
| ''/mnt/d/...'' | Langsam (Windows-Dateisystem) |
| ''~/...'' | Schnell (Linux-Dateisystem) |

**Empfehlung für Build:**

<code bash>
# Quellen nach Linux kopieren
cp -r /mnt/d/Projects/openssl-3.6.0/src ~/openssl-src

# Im Linux-Dateisystem bauen
cd ~/openssl-src
./Configure linux-x86_64 --prefix=~/openssl-build
make -j$(nproc)

# Ergebnis nach Windows kopieren
cp -r ~/openssl-build /mnt/d/Projects/openssl-3.6.0/linux-build/
</code>

----

===== Häufige Probleme =====

==== "WSL2 requires an update to its kernel component" ====

<code powershell>
# WSL-Kernel aktualisieren
wsl --update
</code>

==== "Virtualization is not enabled" ====

Im BIOS aktivieren:
  * Intel: "Intel Virtualization Technology (VT-x)"
  * AMD: "SVM Mode"

==== Langsame I/O Performance ====

Arbeiten Sie im Linux-Dateisystem (''~/'') statt unter ''/mnt/''.

----

===== Weiter zu =====

  * [[.:vorbereitung:emscripten|Emscripten SDK installieren]]
  * [[.:build:linux-wsl|Linux Build]]
  * [[.:vorbereitung:start|Zurück zur Vorbereitung]]

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Post-Quantum Cryptography Professional//