Fejlfinding

Hvis du bruger en tidligere version, skal du bruge sharelatex i stedet for overleaf i stinavne.

Kørsel af Overleaf med et NFS-filsystem

Det er teknisk muligt at montere et NFS-filsystem i en Overleaf-container, men det anbefales ikke og kan give forskellige typer ydelsesfejl.

En almindelig fejl, der ses ved kompileringer, er:

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

Vi fraråder især at bruge NFS-baserede filsystemer til midlertidige data, såsom de mapper, der bruges til kompileringsdata. Vi anbefaler at bruge en lokal scratch-disk, helst en lokal SSD, til følgende mapper.

For docker-compose-baserede opsætninger foreslår vi blot at tilsidesætte bind-mounten fra NFS, hvilket undgår at ændre stier i applikationen. Her er et eksempel på et uddrag af en docker-compose-konfiguration, der bruger en scratch-disk monteret på /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

Der er ikke behov for at migrere eksisterende filer fra NFS til deres nye placering efter opdateringen. LaTeX-compileren kan genskabe alle filerne med en ny fuld kompilering.

Se flere detaljer her: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Kørsel af Overleaf på Windows eller macOS medfører, at tjenesten mongo ikke starter

Hvis du kører Overleaf på Windows eller macOS, kan tjenesten mongo fejle ved genstart med fejlen:

Example error

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

For at undgå denne fejl skal dataene gemmes i et volume i stedet for en bind-monteret mappe (se dokumentationen til mongo-imaget for flere detaljer: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). For at gemme data i Docker-volumes, der er monteret i MongoDB- og Redis-containerne, skal du tilføje følgende til config/docker-compose.override.yml (opret filen, hvis den ikke allerede findes):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data

Se flere oplysninger her: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Opgradering til Redis 6.2 medfører en genstartsløkke

Brug kommandoen docker logs redis til at udskrive en kopi af logfilerne.

Hvis du ser linjen Fatal: Can't initialize Background Jobs, vil det fulde output se nogenlunde sådan ud:

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

Det kan hænge sammen med den Docker-version, der aktuelt bruges. En opdatering til en version >= 20.10.10 bør løse problemet.

Se flere oplysninger i Redis’ upstream-issue: https://github.com/redis/redis/issues/12362

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

Forkert orientering af forhåndsvisnings-/miniaturebilleder i skabelongalleriet

Af og til kan de forhåndsvisnings-/miniaturebilleder, som Server Pro genererer, blive oprettet med forkert orientering og kræve manuel indgriben for at blive rettet. Disse billeder gemmes i /var/lib/overleaf/data/template_files/ (>= 5.0.3) og /var/lib/sharelatex/data/template_files/ (tidligere).

Vi anbefaler, at du tager en sikkerhedskopi af denne mappe, før du foretager ændringer.

Du skal følge nedenstående trin for hver berørt skabelon:

Find skabelonens IDGå til din instans’ skabelongalleri (/templates/all), åbn en berørt skabelon, og kopiér ID’et fra URL’en (for eksempel: https://your-instance-url/templates/6645d346c224815e9460a695).Kør rettelseskommandoenKør følgende kommando fra Docker-værten (erstat skabelon-ID’et med det, du kopierede, og opdater stien, hvis det er relevant):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

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

Kontrollér, at du har aktiveret systemkald. For pdflatex er dette 'pdflatex -shell-escape'.

Kommandoen \write18 er som standard deaktiveret i Community Edition, fordi alle kompileringer sker i den samme sharelatex-container; dette er den sikreste standard.

Hvis du vil aktivere den for pdflatex, skal du oprette en latexmkrc-fil i roden af dit projekt med følgende indhold:

latexmkrc

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

Prøv derefter at kompilere igen.

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