> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vianmääritys

<Info>
  Jos käytät aiempaa versiota, käytä polkujen nimissä `sharelatex`-nimeä `overleaf`-nimen sijaan.
</Info>

<Accordion title="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:

  ```text theme={null}
  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ä:

  ```yaml title="docker-compose excerpt" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem)
</Accordion>

<Accordion title="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ä:

  ```text title="Example error" theme={null}
  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](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):

  ```yaml title="config/docker-compose.override.yml" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting)
</Accordion>

<Accordion title="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ä:

  ```text title="Redis log example" theme={null}
  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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="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ö:

  ```perl title="latexmkrc" theme={null}
  $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](https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape)
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.