Skip to main content

Installation und Deinstallation

Installation

Hypervisor aktivieren. Dieser ist für WSL zwingend notwendig. Installation siehe: https://docs.microsoft.com/de-de/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v

WSL ist im Mircosoft-Store erhältlich. Die folgenden Schritte sind deshalb nicht notwendig.
Bei Windows 10 muss noch der WSL 2 als Standard gesetzt werden. Bei Windows 11 nicht mehr.

  1. Powershell als Administrator ausführen

  2. WSL Distributionen anzeigen

    wsl --list --online
  3. Distribution der Wahl installieren (bei Fehler Powershell erneut ohne Adminrechte öffnen)

    wsl --install -d <Distributions Name>
  4. WSL2 als Default setzen

    wsl --set-default-version 2
  5. einstellen, dass die Distribution immer mit WSL2 startet

    wsl --set-version <Distributions Name> 2
weitere WSL Befehle

Laufende Ubuntu Instanzen anzeigen

wsl --list --verbose

Instanz herunterfahren

wsl --shutdown

Instanz löschen

wsl --unregister Ubuntu

WSL installieren

WSL Installation

    Auf dem lokalen Rechner das Ubuntu-RootFS von Canonical von
    https://cloud-images.ubuntu.com/wsl/releases/24.04/current/ubuntu-noble-wsl-amd64-24.04lts.rootfs.tar.gz
    herunterladen

    auf den LSWITBI kopieren oder über Freigabeordner bereitstellen

    Auf LSWITBI die Powershell öffnen

     z.B.:
    wsl --import Ubuntu2404 C:\Users\DeinBenutzername\Ubuntu2404 C:\Pfad\zu\ubuntu-noble-wsl-amd64-24.04lts.rootfs.tar.gz
        Der erste Parameter ist der Name der Distribution
        Der zweite ist das Installationsverzeichnis
        Der dritte ist die tar.gz-Datei mit dem Root-Filesystem

    Ubuntu starten
    wsl -d Ubuntu2404

3. Ubuntu-Repository einrichten (nur im CPX-Umfeld, nicht lokal)

    Da das Ubuntu-WSL sich nicht direkt in das Internet zum Ubuntu Server für Updates/Installation verbinden kann, muss die Repo-Url auf den nexus.service.piz geändert werden.

    "sudo su" ausführen und anschließend die folgenden URIs in den apt-sourcen ändern:

    nano /etc/apt/sources.list.d/ubuntu.sources
    ## See the sources.list(5) manual page for further settings.
    Types: deb
    #URIs: http://archive.ubuntu.com/ubuntu
    URIs: https://nexus.service.piz/repository/archive.ubuntu.com/ubuntu
    Suites: noble noble-updates noble-backports
    Components: main universe restricted multiverse
    Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

    ## Ubuntu security updates. Aside from URIs and Suites,
    ## this should mirror your choices in the previous section.
    Types: deb
    #URIs: http://security.ubuntu.com/ubuntu
    URIs: https://nexus.service.piz/repository/security.ubuntu.com/ubuntu
    Suites: noble-security
    Components: main universe restricted multiverse
    Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg


    Caplog-X verwendet für die Domain service.piz ein selbstsigniertes TLS-Zertifikate, welches Ubuntu-WSL nicht kennt

    Daher muss das Root CA Zertifikate unter folgender Datei angelegt werden
    nano /usr/local/share/ca-certificates/service-piz-ca-chain.crt Quelle erweitern
    Dann aktivieren
    update-ca-certificates
    Updates durchführen
    apt update && apt dist-upgrade -y
    alte Pakete entfernen
    apt autoremove && apt autoclean
    OPTIONAL auf Deutsch umstellen
    apt install language-pack-de
    dpkg-reconfigure locales

    # de_DE.UTF-8 UTF-8 auswählen
    # "exit" und wieder WSL starten

4. Lokalen Benutzer einrichten
# Eigenen caplogx-Benutzer erstellen analog zu den Linux VMs im CPX-RZ

adduser <user>@LSW-X.DE --allow-bad-names

 

...
New password:
Retype new password:
No password has been supplied.
New password:
Retype new password:
passwd: password updated successfully
Changing the user information for [email protected]
Enter the new value, or press ENTER for the default
        Full Name []:
        Room Number []:
        Work Phone []:
        Home Phone []:
        Other []:
Is the information correct? [Y/n] y
info: Adding new user `[email protected]' to supplemental / extra groups `users' ...
info: Adding user `[email protected]' to group `users' ...


# Benutzer zur Sudo-Gruppe hinzufügen
usermod -aG sudo <user>@LSW-X.DE
# zum Benutzer wechseln
su <user>@LSW-X.DE
# in Home-Ordner wechseln
cd ~/

Proxy in der WSL setzen, wenn notwendig

In der WSL

export http_proxy=http://webproxy01.foo.de:8080
export https_proxy=http://webproxy01.foo.de:8080
export HTTP_PROXY=http://webproxy01.foo.de:8080
export HTTPS_PROXY=http://webproxy01.foo.de:8080

Proxy für APT setzen (permanent)

sudo vim /etc/apt/apt.conf.d/00proxy:
Acquire::HTTP {
  Proxy "http://webproxy01.gisa.dmz:8080";
};
Acquire::HTTPS {
  Proxy "http://webproxy01.gisa.dmz:8080";
};

Windows Laufwerk in WSL einbinden

Prüfen, welcher Laufwerksbuchstabe Windows vergeben hat
z.B. G:\

WSL öffnen
Mount-Ordner anlegen

mkdir /mnt/g

Laufwerk in Ordner anmelden

mount -t drvfs G: /mnt/g

Deinstallation

Powershell öffnen

wsl -l
wsl --unregister <distroName>