Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- rex3d:openfoamremote [2026/08/07 09:23] – [Verwendung auf einem lokalen PC mit WSL] admin
+++ rex3d:openfoamremote [2026/09/02 09:56] (aktuell) – admin
@@ Zeile 1: / Zeile 1: @@
+====== REX3D einrichten ======
 ====== REX3D mit OpenFOAM einrichten ======
-REX3D in der Kombination mit unserem OpenFOAM Solver arbeitet gekapselt in einer Linuxumgebung, so dass neben der erstmaligen Einrichtung für den Zugriff nichts weiter eingestellt werden muss. Die vorgefertigten Container werden von REX automatisch bereitgestellt und eingerichtet.
-Sie haben zwei Möglichkeiten zur Verwendung des OpenFOAM Solver:
-  - Als lokalen Linux Container in einer WSL Umgebung
-  - Remotezugriff auf einem Linux System
-Die Einrichtung der jeweiligen Szenarien erfolgt im folgenden.
+REX3D verwendet in Kombination mit unserem OpenFOAM-Solver eine gekapselte Linux-Umgebung. Nach der einmaligen Einrichtung des Zugriffs sind keine weiteren Konfigurationen erforderlich. Die benötigten Container werden von REX automatisch bereitgestellt und eingerichtet nachdem Sie die //REX3D Abhängigkeiten// heruntergeladen und installiert haben. Die Anleitung hierfür finden Sie hier: [[rex3d:rex3dkonfiguration]].
-===== Verwendung auf einem lokalen PC mit WSL=====
+Für die Verwendung des OpenFOAM-Solvers stehen zwei Varianten zur Verfügung:
-==== Installation von WSL auf dem Client PC ====
-==== Anpassen der Einstellungen in den REX3D Optionen ====
+  * lokaler Betrieb eines Linux-Containers in einer WSL-Umgebung
+  * Remotezugriff auf ein Linux-System
+Die Einrichtung beider Varianten wird in den folgenden Abschnitten beschrieben.
+===== Verwendung auf einem lokalen PC mit WSL =====
+Möchten Sie REX3D mit OpenFOAM lokal verwenden müssen Sie WSL installieren und eine lokale virtuelle Maschine verwenden.
+==== WSL auf dem Client-PC installieren ====
+Öffnen Sie die Windows Powershell mit Adminstrationsberechtigungen und geben Sie folgendes ein:
+<code powershell>
+wsl --install
+</code>
+Anschließend muss das System neugestartet werden.
+==== REX3D-Optionen anpassen ====
+Öffnen Sie anschließend in PSI / REX über das Hauptmenü den Eintrag Optionen > REX3D
+Setzen Sie den Haken bei 'Lokale Maschine nutzen' und tragen Sie als Verbindungsname: **podman-machine-default** ein.
+Durch das Klicken auf den Button 'Anwenden und testen' wird die WSL VM eingerichtet und vorbereitet. In den nächsten Schritten müssen Sie noch RAM, CPU Kerne und Festplattenkapazität der VM festlegen.
+{{ :rex3d:rex19_openfoam_lokal_de.png?nolink |}}
 ===== Verwendung eines Remote-Servers =====
-Der Podman-Remote-Client ermöglicht es, von einem separaten Windows-Client mit einem Podman-Backend auf einem Linux-Server zu kommunizieren. Das Podman-Backend stellt dabei die für REX3D beziehungsweise PSI benötigte OpenFOAM-Umgebung bereit.
+Mit dem Podman-Remote-Client kann ein Windows-PC auf ein Podman-Backend auf einem Linux-Server zugreifen. Das Podman-Backend stellt die für REX3D beziehungsweise PSI benötigte OpenFOAM-Umgebung bereit.
-Aus Sicht von REX3D oder PSI verhält sich die entfernte Podman-Installation weitgehend wie eine lokale Installation.
+Für REX3D beziehungsweise PSI verhält sich die entfernte Podman-Installation weitgehend wie eine lokale Podman-Installation.
 ==== Voraussetzungen ====
@@ Zeile 22: / Zeile 41: @@
 Die Verbindung basiert auf einem Client-Server-Modell.
-Benötigt werden:
+Folgende Komponenten werden benötigt:
-  * ein Linux-Server oder eine Linux-VM,
+  * Linux-Server oder Linux-VM
-  * ein laufender SSH-Dienst auf dem Server,
+  * laufender SSH-Dienst auf dem Server
-  * Podman auf dem Server,
+  * Podman auf dem Server
-  * ein Windows-PC mit einer REX beziehungsweise PSI Version,
+  * Windows-PC mit einer REX- beziehungsweise PSI-Version
-  * OpenSSH und ein Podman-Client auf dem Windows-PC.
+  * OpenSSH-Client auf dem Windows-PC
+  * Podman-Client auf dem Windows-PC
-Die Anleitung geht von Ubuntu 24.04 oder einer vergleichbaren Ubuntu-Version mit ''systemd'' aus. Podman ist in den offiziellen Ubuntu-Paketquellen verfügbar.
+Diese Anleitung basiert auf Ubuntu 24.04 oder einer vergleichbaren Ubuntu-Version mit ''systemd''. Podman ist über die offiziellen Ubuntu-Paketquellen verfügbar.
-In den folgenden Befehlen müssen diese Platzhalter ersetzt werden:
+In den folgenden Befehlen werden Platzhalter verwendet. Ersetzen Sie diese durch die Werte Ihrer Umgebung:
   * %%<SERVER>%%: Hostname oder IP-Adresse des Servers
@@ Zeile 38: / Zeile 58: @@
   * %%<e3d_usr>%%: unprivilegierter Benutzer für Podman und OpenFOAM
   * %%<ssh_podman_e3d_usr>%%: Dateiname des SSH-Schlüssels
+  * %%<UID>%%: numerische Benutzer-ID des Benutzers %%<e3d_usr>%%
 ==== 1. Podman auf dem Server installieren ====
-=== 1.1 Auf dem Server anmelden ===
-Auf dem Windows-PC in PowerShell:
+=== 1.1 Am Server anmelden ===
+Öffnen Sie auf dem Windows-PC PowerShell und stellen Sie eine SSH-Verbindung zum Server her:
 <code powershell>
@@ Zeile 50: / Zeile 72: @@
 === 1.2 Benötigte Pakete installieren ===
-Auf dem Server:
+Aktualisieren Sie zunächst die Paketinformationen:
 <code bash>
 sudo apt-get update
+</code>
-sudo apt-get install -y
+Installieren Sie anschließend die benötigten Pakete:
-podman
-uidmap
+<code bash>
-slirp4netns
+sudo apt-get install podman
-fuse-overlayfs
+</code>
-passt </code>
-Installation prüfen:
+Prüfen Sie die Installation:
 <code bash>
@@ Zeile 70: / Zeile 92: @@
 ==== 2. Podman-Benutzer einrichten ====
-=== 2.1 Benutzer ohne Passwortanmeldung anlegen ===
+=== 2.1 Benutzer ohne lokale Passwortanmeldung anlegen ===
-Als Administrator auf dem Server:
+Legen Sie als Administrator einen separaten Benutzer für Podman und OpenFOAM an:
 <code bash>
 sudo adduser \
   --disabled-password \
-  --gecos "" \
+  --comment "" \
   <e3d_usr>
 </code>
@@ Zeile 83: / Zeile 105: @@
 Der Benutzer erhält kein lokales Passwort. Die Anmeldung erfolgt später ausschließlich über einen SSH-Schlüssel.
-=== 2.2 Home-Dateisystem prüfen ===
+=== 2.2 Dateisystem des Home-Verzeichnisses prüfen ===
+Prüfen Sie, auf welchem Dateisystem sich das Home-Verzeichnis des Benutzers befindet:
 <code bash>
@@ Zeile 89: / Zeile 113: @@
 </code>
-Ein lokales Dateisystem wie ''ext4'', ''xfs'' oder ''btrfs'' eignet sich für den Container-Storage.
+Für den Container-Storage eignen sich lokale Dateisysteme wie ''ext4'', ''xfs'' oder ''btrfs''.
-Bei einem Homeverzeichnis auf NFS sollte für den Podman-Storage ein lokaler Pfad eingerichtet werden. NFS ist als Speicherort für den Rootless-Container-Storage in der Regel nicht geeignet.
+Befindet sich das Home-Verzeichnis auf einem NFS-Dateisystem, richten Sie für den Podman-Storage einen lokalen Speicherpfad ein. NFS ist für Rootless-Container-Storage in der Regel nicht geeignet.
-=== 2.3 User-systemd dauerhaft aktivieren ===
+=== 2.3 Benutzerspezifische systemd-Dienste dauerhaft aktivieren ===
-Damit die benutzerspezifischen systemd-Dienste auch ohne aktive SSH-Sitzung ausgeführt werden, muss für den Benutzer Linger aktiviert werden:
+Damit benutzerspezifische systemd-Dienste auch ohne aktive SSH-Sitzung ausgeführt werden können, aktivieren Sie die Linger-Funktion für den Benutzer:
 <code bash>
@@ Zeile 102: / Zeile 125: @@
 </code>
-Status prüfen:
+Prüfen Sie anschließend den Status:
 <code bash>
@@ Zeile 118: / Zeile 141: @@
 Auf dem Windows-PC muss der OpenSSH-Client installiert sein.
-=== 3.1 OpenSSH prüfen ===
+=== 3.1 OpenSSH-Installation prüfen ===
-In PowerShell:
+Öffnen Sie PowerShell und prüfen Sie, ob die benötigten Programme verfügbar sind:
 <code powershell>
@@ Zeile 129: / Zeile 152: @@
 ssh.exe -V </code>
-Windows OpenSSH enthält unter anderem die Programme ''ssh'', ''scp'' und ''ssh-keygen''.
+OpenSSH für Windows stellt unter anderem die Programme ''ssh'', ''scp'' und ''ssh-keygen'' bereit.
 === 3.2 SSH-Schlüssel erzeugen ===
-Pfad des neuen Schlüssels festlegen:
+Legen Sie zunächst den Pfad für den neuen SSH-Schlüssel fest:
 <code powershell>
@@ Zeile 139: / Zeile 162: @@
 </code>
-Das Verzeichnis ''.ssh'' erstellen, falls es noch nicht vorhanden ist:
+Erstellen Sie das Verzeichnis ''.ssh'', falls es noch nicht vorhanden ist:
 <code powershell>
@@ Zeile 149: / Zeile 172: @@
 </code>
-Prüfen, ob unter dem gewählten Namen bereits ein Schlüssel vorhanden ist:
+Prüfen Sie, ob unter dem gewählten Namen bereits Schlüsseldateien vorhanden sind:
 <code powershell>
@@ Zeile 156: / Zeile 179: @@
 </code>
-Beide Befehle sollten ''False'' zurückgeben.
+Beide Befehle sollten folgende Ausgabe liefern:
-Falls bereits Dateien vorhanden sind, darf der folgende Befehl erst ausgeführt werden, nachdem geprüft wurde, ob diese Schlüssel noch benötigt werden.
+<code text>
+False
+</code>
+**Hinweis:** Sind unter dem angegebenen Pfad bereits Dateien vorhanden, prüfen Sie vor dem nächsten Schritt, ob diese Schlüssel noch benötigt werden. Vorhandene Schlüssel dürfen nicht unbeabsichtigt überschrieben werden.
-SSH-Schlüssel erzeugen:
+Erzeugen Sie anschließend einen neuen SSH-Schlüssel:
 <code powershell>
@@ Zeile 170: / Zeile 197: @@
 </code>
-Dabei entstehen zwei Dateien:
+Dabei werden zwei Dateien erzeugt:
 <code text>
@@ Zeile 177: / Zeile 204: @@
 </code>
-Der private Schlüssel darf den Windows-PC, auf dem REX3D beziehungsweise PSI installiert ist, nicht verlassen.
+**Wichtig:** Der private Schlüssel darf den Windows-PC, auf dem REX3D beziehungsweise PSI installiert ist, nicht verlassen.
-=== 3.3 Öffentlichen Schlüssel auf den Server kopieren ===
+=== 3.3 Öffentlichen Schlüssel auf den Server übertragen ===
-In PowerShell:
+Kopieren Sie den öffentlichen Schlüssel zunächst in das temporäre Verzeichnis des Servers:
 <code powershell>
@@ Zeile 189: / Zeile 216: @@
 </code>
-Anschließend als Administrator am Server anmelden:
+Melden Sie sich anschließend als Administrator auf dem Server an:
 <code powershell>
@@ Zeile 195: / Zeile 222: @@
 </code>
-=== 3.4 Schlüssel für den Podman-Benutzer installieren ===
+=== 3.4 Öffentlichen Schlüssel für den Podman-Benutzer installieren ===
-Auf dem Server zunächst das SSH-Verzeichnis erstellen:
+Erstellen Sie zunächst das SSH-Verzeichnis des Podman-Benutzers:
 <code bash>
@@ Zeile 208: / Zeile 235: @@
 </code>
-Den öffentlichen Schlüssel als ''authorized_keys'' installieren:
+Installieren Sie anschließend den öffentlichen Schlüssel als ''authorized_keys'':
 <code bash>
@@ Zeile 219: / Zeile 246: @@
 </code>
-Die temporäre Datei löschen:
+Löschen Sie danach die temporäre Datei:
 <code bash>
@@ Zeile 225: / Zeile 252: @@
 </code>
-Berechtigungen prüfen:
+Prüfen Sie abschließend die Berechtigungen:
 <code bash>
@@ Zeile 234: / Zeile 261: @@
 === 3.5 SSH-Anmeldung als Podman-Benutzer testen ===
-Auf dem Windows-PC:
+Stellen Sie auf dem Windows-PC eine SSH-Verbindung mit dem neu erzeugten Schlüssel her:
 <code powershell>
@@ Zeile 242: / Zeile 269: @@
 </code>
-Nach der Anmeldung auf dem Server prüfen:
+Prüfen Sie nach der Anmeldung Benutzer, Gruppen und Arbeitsverzeichnis:
 <code bash>
@@ Zeile 250: / Zeile 277: @@
 </code>
-Erwartet werden unter anderem:
+Unter anderem werden folgende Werte erwartet:
 <code text>
@@ Zeile 259: / Zeile 286: @@
 Die Ausgabe von ''id'' muss die Benutzer- und Gruppeninformationen des Benutzers %%<e3d_usr>%% anzeigen.
-Optional kann die SSH-Verbindung direkt vom Windows-PC aus geprüft werden:
+Optional können Sie die SSH-Verbindung direkt vom Windows-PC aus testen:
 <code powershell>
@@ Zeile 270: / Zeile 297: @@
 ==== 4. Podman-Socket auf dem Server aktivieren ====
-=== 4.1 Podman als Benutzer testen ===
+=== 4.1 Podman als unprivilegierter Benutzer testen ===
-Als %%<e3d_usr>%% auf dem Server:
+Melden Sie sich als %%<e3d_usr>%% auf dem Server an und führen Sie folgenden Befehl aus:
 <code bash>
@@ Zeile 278: / Zeile 305: @@
 </code>
-Der Befehl muss ohne ''sudo'' ausgeführt werden.
+**Wichtig:** Der Befehl muss ohne ''sudo'' ausgeführt werden.
 === 4.2 Podman-Socket aktivieren ===
-Als %%<e3d_usr>%% auf dem Server:
+Aktivieren Sie als Benutzer %%<e3d_usr>%% den Podman-Socket:
 <code bash>
@@ Zeile 288: / Zeile 315: @@
 </code>
-Status prüfen:
+Prüfen Sie anschließend den Status:
 <code bash>
@@ Zeile 294: / Zeile 321: @@
 </code>
-=== 4.3 Socket-Pfad prüfen ===
+=== 4.3 Socket-Pfad ermitteln ===
+Prüfen Sie den Pfad des Podman-Sockets:
 <code bash>
@@ Zeile 301: / Zeile 330: @@
 </code>
-Der Rootless-Podman-Socket liegt standardmäßig unter:
+Der Rootless-Podman-Socket befindet sich standardmäßig unter:
 <code text>
@@ Zeile 307: / Zeile 336: @@
 </code>
-Die numerische UID des Benutzers kann mit folgendem Befehl ermittelt werden:
+Ermitteln Sie die numerische UID des Benutzers mit folgendem Befehl:
 <code bash>
@@ Zeile 313: / Zeile 342: @@
 </code>
-Podman verwendet für den API-Socket die systemd-Socket-Aktivierung. Zusammen mit ''loginctl enable-linger'' bleibt der Socket auch ohne aktive SSH-Anmeldung verfügbar.
+Notieren Sie die ausgegebene UID. Sie wird später für die Einrichtung der Podman-Remote-Verbindung benötigt.
+Podman verwendet für den API-Socket die systemd-Socket-Aktivierung. In Verbindung mit ''loginctl enable-linger'' bleibt der Socket auch ohne aktive SSH-Sitzung verfügbar.
 ==== 5. Podman-Remote-Verbindung auf dem Windows-PC einrichten ====
@@ Zeile 319: / Zeile 350: @@
 Auf dem Windows-PC muss ein Podman-Client installiert sein.
-=== 5.1 Verbindung hinzufügen ===
+=== 5.1 Podman-Verbindung hinzufügen ===
-In PowerShell:
+Öffnen Sie PowerShell und legen Sie eine neue Podman-Verbindung an:
 <code powershell>
 podman.exe system connection add `
-    rex3d-openfoam `
+    remote-vm-ktp `
     --identity "$env:USERPROFILE\.ssh\<ssh_podman_e3d_usr>" `
     "ssh://<e3d_usr>@<SERVER>/run/user/<UID>/podman/podman.sock"
 </code>
-Dabei ist %%<UID>%% durch die numerische UID des Benutzers %%<e3d_usr>%% zu ersetzen.
-Beispiel:
+=== 5.2 Podman-Verbindung anzeigen ===
-<code text>
+Zeigen Sie die konfigurierten Verbindungen an:
-ssh://e3d@openfoam-server.example.org/run/user/1001/podman/podman.sock
-</code>
-=== 5.2 Verbindung anzeigen ===
 <code powershell>
@@ Zeile 344: / Zeile 370: @@
 </code>
-Die neue Verbindung sollte in der Liste erscheinen.
+Die Verbindung ''remote-vm-ktp'' sollte in der Liste erscheinen.
-=== 5.3 Verbindung testen ===
+=== 5.3 Podman-Verbindung testen ===
+Testen Sie die Verbindung:
 <code powershell>
 podman.exe `
-    --connection rex3d-openfoam `
+    --connection remote-vm-ktp `
     info
 </code>
-Optional kann zusätzlich ein Testcontainer ausgeführt werden:
+Der Befehl sollte Informationen zur Podman-Installation auf dem Linux-Server anzeigen.
-<code powershell>
-podman.exe `
-    --connection rex3d-openfoam `
-    run `
-    --rm `
-    docker.io/library/alpine:latest `
-    uname -a
-</code>
-Der Container wird auf dem Linux-Server und nicht auf dem Windows-PC ausgeführt.
+Der Container wird auf dem Linux-Server ausgeführt. Auf dem Windows-PC wird lediglich der Podman-Remote-Client verwendet.
 ==== 6. Podman-Verbindung in REX3D konfigurieren ====
-In den REX3D-Optionen muss der Name der zuvor angelegten Podman-Verbindung eingetragen werden.
+Öffnen Sie die REX3D-Optionen und tragen Sie dort den Namen der zuvor angelegten Podman-Verbindung ein.
 Bei Verwendung der Befehle aus dieser Anleitung lautet der Verbindungsname:
 <code text>
-rex3d-openfoam
+remote-vm-ktp
 </code>
-Die verfügbaren Verbindungen können jederzeit mit folgendem Befehl angezeigt werden:
+**Entfernen** Sie den Haken bei 'Lokale Maschine nutzen'
+{{ :rex3d:rex19_openfoam_remote_de.png?nolink |}}
+Die verfügbaren Podman-Verbindungen können jederzeit mit folgendem Befehl über die Powershell angezeigt werden:
 <code powershell>
@@ Zeile 383: / Zeile 407: @@
 </code>
+Nach erfolgreicher Konfiguration kann REX3D die OpenFOAM-Container über die eingerichtete Podman-Remote-Verbindung auf dem Linux-Server verwenden.
 ==== Sicherheitshinweise ====
-Der Podman-API-Socket erlaubt die vollständige Verwaltung aller Container, Images, Volumes und Pods des Benutzers %%<e3d_usr>%%.
+Der Podman-API-Socket ermöglicht die vollständige Verwaltung aller Container, Images, Volumes und Pods des Benutzers %%<e3d_usr>%%.
-Der Socket darf daher nicht über einen ungeschützten TCP-Port veröffentlicht werden. Der Zugriff über SSH auf den benutzereigenen Unix-Socket ist die bevorzugte Variante.
+**Wichtig:** Veröffentlichen Sie den Podman-Socket nicht über einen ungeschützten TCP-Port. Verwenden Sie stattdessen den in dieser Anleitung beschriebenen Zugriff über SSH auf den benutzereigenen Unix-Socket.
-Der Benutzer %%<e3d_usr>%% sollte:
+Für den Benutzer %%<e3d_usr>%% gelten folgende Empfehlungen:
-  * keine ''sudo''-Rechte besitzen,
+  * Der Benutzer sollte **keine** ''sudo''-Rechte besitzen.
-  * nicht Mitglied privilegierter Gruppen sein,
+  * Der Benutzer sollte **kein** Mitglied privilegierter Gruppen sein.
-  * nur auf die benötigten Dateien und Verzeichnisse zugreifen können,
+  * Der Benutzer sollte **ausschließlich** auf die benötigten Dateien und Verzeichnisse zugreifen können.
-  * ausschließlich für REX3D, PSI und die zugehörigen OpenFOAM-Container verwendet werden,
+  * Der Benutzer sollte **ausschließlich** für REX3D, PSI und die zugehörigen OpenFOAM-Container verwendet werden.
-  * einen eigenen SSH-Schlüssel verwenden,
+  * Für den Benutzer sollte ein eigener SSH-Schlüssel verwendet werden.
-  * keine privaten Schlüssel anderer Benutzer erhalten.
+  * Dem Benutzer dürfen **keine** privaten Schlüssel anderer Benutzer zur Verfügung gestellt werden.
-Der private SSH-Schlüssel auf dem Windows-PC sollte:
-  * nur für diesen Verwendungszweck eingesetzt werden,
+===Weitere Themen===
-  * nicht per E-Mail oder über gemeinsame Netzlaufwerke verteilt werden,
+  * [[rex3d:rex3dpreprocessing|]]
-  * durch geeignete Dateiberechtigungen geschützt werden,
+  * [[rex3d:rex3dpostprocessing|]]
-  * bei Verlust oder bei einem Gerätewechsel aus ''authorized_keys'' entfernt werden.
+  * [[rex3d:rex3dkonfiguration|]]
+  * [[rex3d:openfoamremote|]]