Feilsøking

Hvis du bruker en tidligere versjon, bruker du sharelatex i stedet for overleaf i stinavn.

Kjøre Overleaf med et NFS-filsystem

Det er teknisk mulig å montere et NFS-filsystem i en Overleaf-container, men det anbefales ikke og kan føre til ulike typer ytelsesfeil.

En vanlig feil som oppstår ved kompilering, er:

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

Vi fraråder spesielt å bruke NFS-baserte filsystemer for flyktige data, som katalogene som brukes til kompileringsdata. Vi anbefaler å bruke en lokal scratch-disk, helst en lokal SSD, for følgende kataloger.

For docker-compose-baserte oppsett foreslår vi at du ganske enkelt overstyrer bind-monteringen fra NFS, slik at du unngår å endre stier i applikasjonen. Her er et eksempelutdrag fra en docker-compose-konfigurasjon som bruker en scratch-disk montert 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

Det er ikke nødvendig å migrere eksisterende filer fra NFS til den nye plasseringen etter oppdateringen. LaTeX-kompilatoren kan gjenskape alle filene ved å kjøre en full kompilering på nytt.

For mer informasjon, se: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Når Overleaf kjøres på Windows eller macOS, starter ikke mongo-tjenesten

Hvis du kjører Overleaf på Windows eller macOS, kan det hende mongo-tjenesten ikke klarer å starte på nytt, med feilen:

Example error

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

For å unngå denne feilen må dataene lagres i et volum i stedet for en bind-montert katalog (se dokumentasjonen for mongo-imaget for mer informasjon: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). For å lagre data i Docker-volumer som er montert i MongoDB- og Redis-containerne, legger du til følgende i config/docker-compose.override.yml (opprett filen hvis den ikke finnes ennå):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data

For mer informasjon, se: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Oppgradering til Redis 6.2 fører til en omstartsløkke

Bruk kommandoen docker logs redis for å skrive ut en kopi av loggene.

Hvis du ser linjen Fatal: Can't initialize Background Jobs, vil hele utdataene se omtrent slik ut:

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

Dette kan ha sammenheng med Docker-versjonen som er i bruk. Oppdatering til en versjon >= 20.10.10 bør løse problemet.

For mer informasjon, se Redis-saken oppstrøms: https://github.com/redis/redis/issues/12362

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

Feil orientering på forhåndsvisnings-/miniatyrbilder i malgalleriet

Av og til kan forhåndsvisnings-/miniatyrbildene som genereres av Server Pro, bli opprettet med feil orientering og kreve manuell korrigering. Disse bildene lagres i /var/lib/overleaf/data/template_files/ (>= 5.0.3) og /var/lib/sharelatex/data/template_files/ (tidligere versjoner).

Vi anbefaler å ta sikkerhetskopi av denne mappen før du gjør endringer.

Du må følge trinnene nedenfor for hver berørt mal:

Finn mal-ID-enGå til malgalleriet i instansen din (/templates/all), åpne en berørt mal og kopier ID-en fra URL-en (for eksempel: https://your-instance-url/templates/6645d346c224815e9460a695).Kjør korreksjonskommandoenKjør følgende kommando fra Docker-verten (erstatt mal-ID-en med den du kopierte, og oppdater stien om nødvendig):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

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

Kontroller at du har aktivert systemkall. For pdflatex er dette 'pdflatex -shell-escape'.

Kommandoen \write18 er deaktivert som standard i Community Edition fordi alle kompileringer skjer i den samme sharelatex-containeren; dette er den sikreste standardinnstillingen.

Hvis du vil aktivere den for pdflatex, oppretter du en latexmkrc-fil i roten av prosjektet ditt med følgende innhold:

latexmkrc

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

Prøv deretter å kompilere på nytt.

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