Fehlerbehebung

Wenn Sie eine ältere Version verwenden, nutzen Sie in Pfadnamen bitte sharelatex statt overleaf.

Overleaf mit einem NFS-Dateisystem betreiben

Das Einbinden eines NFS-Dateisystems in einen Overleaf-Container ist technisch möglich, wird jedoch nicht empfohlen und kann zu verschiedenen Arten von Performance-Fehlern führen.

Ein häufiger Fehler beim Kompilieren ist:

EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'

Insbesondere raten wir davon ab, NFS-basierte Dateisysteme für flüchtige Daten zu verwenden, etwa für die Verzeichnisse mit Kompilierungsdaten. Wir empfehlen für die folgenden Verzeichnisse eine lokale Scratch-Disk, vorzugsweise eine lokale SSD.

Bei docker-compose-basierten Setups empfehlen wir, einfach den Bind-Mount vom NFS zu überschreiben, sodass Pfade in der Anwendung nicht geändert werden müssen. Hier ein Beispiel für einen Auszug aus einer docker-compose-Konfiguration mit einer unter /scratch eingebundenen Scratch-Disk:

docker-compose excerpt

services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp

Nach der Umstellung müssen keine vorhandenen Dateien vom NFS an ihren neuen Speicherort migriert werden. Der LaTeX-Compiler kann alle Dateien mit einem vollständigen Kompilierungsdurchlauf neu erzeugen.

Weitere Details finden Sie unter: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Unter Windows oder macOS startet der Dienst mongo nicht

Wenn Sie Overleaf unter Windows oder macOS betreiben, kann der Neustart des Dienstes mongo mit folgendem Fehler fehlschlagen:

Example error

Failed to start up WiredTiger under any compatibility version.
Reason: 1: Operation not permitted

Um diesen Fehler zu vermeiden, müssen die Daten in einem Volume statt in einem per Bind-Mount eingebundenen Verzeichnis gespeichert werden (weitere Details in der Dokumentation des mongo-Images: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Um Daten in Docker-Volumes zu speichern, die in die MongoDB- und Redis-Container eingebunden werden, fügen Sie Folgendes zu config/docker-compose.override.yml hinzu (legen Sie die Datei an, falls sie noch nicht existiert):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data

Weitere Informationen finden Sie unter: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Upgrade auf Redis 6.2 führt zu einer Neustartschleife

Verwenden Sie den Befehl docker logs redis, um eine Kopie der Logs auszugeben.

Wenn Sie die Zeile Fatal: Can't initialize Background Jobs sehen, sieht die vollständige Ausgabe etwa so aus:

Redis log example

1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo

Dies kann mit der aktuell verwendeten Docker-Version zusammenhängen. Ein Update auf Version >= 20.10.10 sollte das Problem beheben.

Weitere Informationen finden Sie im Upstream-Issue von Redis: https://github.com/redis/redis/issues/12362

Referenz: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop

Falsche Ausrichtung der Vorschau-/Miniaturbilder in der Vorlagengalerie

Gelegentlich werden die von Server Pro erzeugten Vorschau-/Miniaturbilder falsch ausgerichtet und müssen manuell korrigiert werden. Diese Bilder werden in /var/lib/overleaf/data/template_files/ (>= 5.0.3) bzw. /var/lib/sharelatex/data/template_files/ (ältere Versionen) gespeichert.

Wir empfehlen, diesen Ordner zu sichern, bevor Sie Änderungen vornehmen.

Führen Sie für jede betroffene Vorlage die folgenden Schritte aus:

Vorlagen-ID ermitteln: Navigieren Sie zur Vorlagengalerie Ihrer Instanz (/templates/all), öffnen Sie eine betroffene Vorlage und kopieren Sie die ID aus der URL (zum Beispiel: https://your-instance-url/templates/6645d346c224815e9460a695). Korrekturbefehl ausführen: Führen Sie den folgenden Befehl auf dem Docker-Host aus (ersetzen Sie die Vorlagen-ID durch die kopierte ID und passen Sie den Pfad bei Bedarf an): docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

Referenz: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images

Bitte prüfen Sie, ob Systemaufrufe aktiviert sind. Für pdflatex lautet dies 'pdflatex -shell-escape'.

Der Befehl \write18 ist in der Community Edition standardmäßig deaktiviert, da alle Kompilierungen im selben Container sharelatex stattfinden; dies ist die sicherere Voreinstellung.

Wenn Sie ihn für pdflatex aktivieren möchten, erstellen Sie im Stammverzeichnis Ihres Projekts eine Datei latexmkrc mit folgendem Inhalt:

latexmkrc

$pdflatex = 'pdflatex --shell-escape';

Kompilieren Sie anschließend erneut.

Referenz: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape