POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Erste Schritte

Linux: Installation mit Docker

Verwenden Sie das veröffentlichte POSIM-Image, wenn Ihr Desktop eine andere Ubuntu-Version oder Linux-Distribution nutzt. Diese Anleitung gilt für AMD64 auf einem x86-64-Rechner mit X11 oder XWayland. Für Ubuntu 26.04 empfehlen wir die native Installation.

1. Docker und Anzeige vorbereiten

Installieren Sie Docker Engine für Ihre Distribution. Für Ubuntu gibt es eine eigene Anleitung. Falls Ihr Konto docker nicht ausführen kann, erledigen Sie die Schritte nach der Installation.

Öffnen Sie ein Terminal in Ihrer Desktop-Sitzung und installieren Sie xauth. Unter Ubuntu:

sudo apt update
sudo apt install -y xauth

Prüfen Sie die Display-Adresse und die Serverversion:

printf '%s\n' "$DISPLAY"
docker version --format '{{.Server.Version}}'

2. POSIM herunterladen

docker pull ioeslab/posim:latest

Der Docker-Leitfaden erklärt die Auswahl eines Quellstands und lokale Builds. Der erste Start nutzt Software-Rendering und kann langsamer sein als eine native Installation mit GPU.

3. Den Zugriff auf die Anzeige erlauben

Kopieren Sie die X11-Berechtigung Ihrer Sitzung in eine Datei, die nur Ihr Konto lesen kann:

mkdir -p "$HOME/.cache/posim"
export POSIM_XAUTH="$HOME/.cache/posim/xauthority"
touch "$POSIM_XAUTH"
chmod 600 "$POSIM_XAUTH"
xauth nlist "$DISPLAY" | sed -e 's/^..../ffff/' | xauth -f "$POSIM_XAUTH" nmerge -
test -s "$POSIM_XAUTH"

Der letzte Befehl prüft, ob die Datei Daten enthält. Falls er fehlschlägt, prüfen Sie die Zugehörigkeit des Terminals zur Desktop-Sitzung und die Verfügbarkeit von XWayland. Korrigieren Sie die Berechtigung, bevor Sie fortfahren.

4. Den Container erstellen

docker run -d --name posim --init --shm-size=1g \
  -e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
  -e XAUTHORITY=/tmp/posim.xauth \
  --mount type=bind,source=/tmp/.X11-unix,target=/tmp/.X11-unix,readonly \
  --mount "type=bind,source=$POSIM_XAUTH,target=/tmp/posim.xauth,readonly" \
  --mount type=volume,source=posim-data,target=/work \
  --entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'

Speichern Sie eigene Modelle und Aufzeichnungen unter /work im Volume posim-data. Mit docker stop posim und docker start posim stoppen und starten Sie den Container. Falls die Anzeige nach einer neuen Linux-Anmeldung nicht mehr funktioniert, erneuern Sie die Berechtigungsdatei.

Für die Übungen bereiten Sie zwei Terminals vor, die beide mit diesem Container verbunden sind. Lesen Sie vor der Nutzung von Hardwarebeschleunigung oder CUDA-Sonar die GPU-Einrichtung.

5. Die Beispielwelt starten

Öffnen Sie eine Sitzung im Container:

docker exec -it posim bash

Führen Sie darin den abschließenden Test aus:

source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
  world_name:=posim_ocean_waves headless:=false

Gazebo sollte die Ozeanwelt öffnen. Lassen Sie das Terminal während der Simulation geöffnet und beenden Sie sie mit Strg+C. Danach folgt Ihre erste Simulation.