Vianmääritys

Jos käytät aiempaa versiota, käytä polkujen nimissä sharelatex-nimeä overleaf-nimen sijaan.

Overleafin ajaminen NFS-tiedostojärjestelmällä

NFS-tiedostojärjestelmän liittäminen Overleaf-konttiin on teknisesti mahdollista, mutta sitä ei suositella, ja se voi aiheuttaa monenlaisia suorituskykyvirheitä.

Yksi yleinen käännösten yhteydessä esiintyvä virhe on:

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

Erityisesti emme suosittele NFS-pohjaisten tiedostojärjestelmien käyttöä tilapäiselle datalle, kuten käännösdatan hakemistoille. Suosittelemme seuraaville hakemistoille paikallista työlevyä, mieluiten paikallista SSD-levyä.

docker-compose-pohjaisissa asennuksissa suosittelemme yksinkertaisesti ohittamaan NFS:n bind-mount-liitoksen, jolloin sovelluksen polkuja ei tarvitse muuttaa. Tässä on ote docker-compose-määrityksestä, jossa käytetään polkuun /scratch liitettyä työlevyä:

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

Olemassa olevia tiedostoja ei tarvitse siirtää NFS:ltä uuteen sijaintiin päivityksen jälkeen. LaTeX-kääntäjä voi luoda kaikki tiedostot uudelleen täydellä käännösajolla.

Lisätietoja: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Overleafin ajaminen Windowsissa tai macOS:ssä estää mongo-palvelun käynnistymisen

Jos ajat Overleafia Windowsissa tai macOS:ssä, mongo-palvelun uudelleenkäynnistys voi epäonnistua virheellä:

Example error

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

Tämän virheen välttämiseksi data on tallennettava volyymiin eikä bind-mount-liitettyyn hakemistoon (katso lisätietoja mongo-imagen dokumentaatiosta: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Jos haluat tallentaa datan MongoDB- ja Redis-kontteihin liitettyihin Docker-volyymeihin, lisää seuraava tiedostoon config/docker-compose.override.yml (luo tiedosto, jos sitä ei vielä ole):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data

Lisätietoja: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Päivitys Redis 6.2:een johtaa uudelleenkäynnistyssilmukkaan

Tulosta kopio lokeista komennolla docker logs redis.

Jos näet rivin Fatal: Can't initialize Background Jobs, koko tuloste näyttää suunnilleen tältä:

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

Tämä voi liittyä käytössä olevaan Docker-versioon. Päivittäminen versioon >= 20.10.10 pitäisi ratkaista ongelman.

Lisätietoja on Redisin upstream-issuessa: https://github.com/redis/redis/issues/12362

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

Mallipohjagallerian esikatselu-/pikkukuvien virheellinen suunta

Joskus Server Pron luomat esikatselu-/pikkukuvat voivat syntyä väärin päin, ja niiden korjaaminen vaatii manuaalista toimenpidettä. Nämä kuvat tallennetaan hakemistoon /var/lib/overleaf/data/template_files/ (>= 5.0.3) ja /var/lib/sharelatex/data/template_files/ (aiemmat versiot).

Suosittelemme varmuuskopioimaan tämän kansion ennen muutosten tekemistä.

Noudata seuraavia vaiheita jokaiselle ongelmasta kärsivälle mallipohjalle:

Etsi mallipohjan ID: Siirry instanssisi mallipohjagalleriaan (/templates/all), avaa ongelmallinen mallipohja ja kopioi ID URL-osoitteesta (esimerkiksi: https://your-instance-url/templates/6645d346c224815e9460a695). Aja korjauskomento: Aja seuraava komento Docker-isännässä (korvaa mallipohjan ID kopioimallasi ID:llä ja päivitä polku tarvittaessa): docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

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

Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.

\write18-komento on Community Editionissa oletuksena pois käytöstä, koska kaikki käännökset tapahtuvat samassa sharelatex-kontissa; tämä on turvallisempi oletus.

Jos haluat ottaa sen käyttöön pdflatexille, luo projektisi juureen latexmkrc-tiedosto, jossa on seuraava sisältö:

latexmkrc

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

Yritä sitten kääntää uudelleen.

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