Rozwiązywanie problemów

Jeśli używasz wcześniejszej wersji, w nazwach ścieżek używaj sharelatex zamiast overleaf.

Uruchamianie Overleaf z systemem plików NFS

Zamontowanie systemu plików NFS w kontenerze Overleaf jest technicznie możliwe, ale nie jest zalecane i może prowadzić do różnego rodzaju problemów z wydajnością.

Jednym z częstych błędów pojawiających się przy kompilacji jest:

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

W szczególności odradzamy używanie systemów plików opartych na NFS dla danych tymczasowych, takich jak katalogi używane do przechowywania danych kompilacji. Dla poniższych katalogów zalecamy używanie lokalnego dysku roboczego (scratch), najlepiej lokalnego dysku SSD.

W konfiguracjach opartych na docker-compose sugerujemy po prostu nadpisanie montowania (bind-mount) z NFS, co pozwala uniknąć zmiany ścieżek w aplikacji. Oto przykładowy fragment konfiguracji docker-compose z użyciem dysku roboczego zamontowanego w /scratch:

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

Po aktualizacji nie ma potrzeby migrowania istniejących plików z NFS do nowej lokalizacji. Kompilator LaTeX może odtworzyć wszystkie pliki podczas ponownej pełnej kompilacji.

Więcej szczegółów: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Uruchomienie Overleaf w systemie Windows lub macOS powoduje, że usługa mongo nie startuje

Jeśli uruchamiasz Overleaf w systemie Windows lub macOS, usługa mongo może nie zrestartować się, zgłaszając błąd:

Example error

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

Aby uniknąć tego błędu, dane muszą być przechowywane w wolumenie, a nie w katalogu montowanym przez bind mount (więcej szczegółów w dokumentacji obrazu mongo: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Aby przechowywać dane w wolumenach Docker montowanych w kontenerach MongoDB i Redis, dodaj poniższe wpisy do config/docker-compose.override.yml (utwórz ten plik, jeśli jeszcze nie istnieje):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data

Więcej informacji: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Aktualizacja do Redis 6.2 powoduje pętlę restartów

Użyj polecenia docker logs redis, aby wyświetlić kopię logów.

Jeśli widzisz wiersz Fatal: Can't initialize Background Jobs, pełne wyjście będzie wyglądać mniej więcej tak:

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

Może to być związane z aktualnie używaną wersją Dockera. Aktualizacja do wersji >= 20.10.10 powinna rozwiązać ten problem.

Więcej informacji znajdziesz w zgłoszeniu w projekcie Redis: https://github.com/redis/redis/issues/12362

Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop

Nieprawidłowa orientacja obrazów podglądu/miniatur w galerii szablonów

Czasami obrazy podglądu/miniatur generowane przez Server Pro mogą zostać utworzone w złej orientacji i wymagać ręcznej korekty. Obrazy te są przechowywane w /var/lib/overleaf/data/template_files/ (>= 5.0.3) oraz /var/lib/sharelatex/data/template_files/ (wcześniejsze wersje).

Przed wprowadzeniem jakichkolwiek zmian zalecamy wykonanie kopii zapasowej tego folderu.

Dla każdego problematycznego szablonu wykonaj poniższe kroki:

Znajdź identyfikator szablonuPrzejdź do galerii szablonów swojej instancji (/templates/all), otwórz problematyczny szablon i skopiuj identyfikator z adresu URL (na przykład: https://your-instance-url/templates/6645d346c224815e9460a695).Uruchom polecenie korygująceUruchom na hoście Docker poniższe polecenie (zastąp identyfikator szablonu skopiowanym i w razie potrzeby zaktualizuj ścieżkę):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images

Sprawdź, czy wywołania systemowe są włączone. Dla pdflatex jest to 'pdflatex -shell-escape'.

Polecenie \write18 jest domyślnie wyłączone w Community Edition, ponieważ wszystkie kompilacje odbywają się w tym samym kontenerze sharelatex; jest to bezpieczniejsze ustawienie domyślne.

Jeśli chcesz włączyć je dla pdflatex, utwórz w katalogu głównym projektu plik latexmkrc o następującej zawartości:

latexmkrc

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

Następnie spróbuj ponownie skompilować projekt.

Źródło: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape