> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/fi/tuki/troubleshooting.md).

# Vianmääritys

{% hint style="info" %}
Jos käytät aiempaa versiota, käytä `sharelatex` eikä `overleaf` polkujen nimissä.
{% endhint %}

<details>

<summary>Overleafin käyttäminen NFS-tiedostojärjestelmän kanssa</summary>

NFS-tiedostojärjestelmän liittäminen Overleaf-konttiin on teknisesti mahdollista, mutta sitä ei suositella, ja se voi johtaa erityyppisiin suorituskykyvirheisiin.

Yksi yleinen virhe, jonka käännökset kohtaavat, on:

```
EBUSY: resurssi on varattu tai lukittu, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Erityisesti emme suosittele NFS-taustaisia tiedostojärjestelmiä tilapäiselle datalle, kuten käännösdatalle käytettäville hakemistoille. Suosittelemme käyttämään paikallista scratch-levyä, mieluiten paikallista SSD-levyä seuraaville hakemistoille.

Kohteelle `docker-compose` pohjaisissa asennuksissa suosittelemme vain NFS:n bind-mountin ohittamista, mikä välttää polkujen muuttamisen sovelluksessa. Tässä on esimerkki `docker-compose` konfiguraatiokatkelma, jossa käytetään scratch-levyä, joka on liitetty kohtaan `/scratch`:

{% code title="docker-compose-katkelma" %}

```yaml
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
```

{% endcode %}

Ei ole tarpeen siirtää mitään olemassa olevia tiedostoja NFS:stä niiden uuteen sijaintiin päivityksen jälkeen. LaTeX-kääntäjä voi luoda kaikki tiedostot uudelleen täydellä käännöskerralla.

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

</details>

<details>

<summary>Overleafin käyttäminen Windowsissa tai macOS:ssa johtaa siihen, että `mongo`-palvelu ei käynnisty</summary>

Jos käytät Overleafia Windowsissa tai macOS:ssa,  `mongo` palvelu ei ehkä käynnisty uudelleen, ja virhe on:

{% code title="Esimerkkivirhe" %}

```
WiredTigeria ei voitu käynnistää millään yhteensopivuusversiolla.
Syy: 1: Toiminto ei ole sallittu
```

{% endcode %}

Tämän virheen välttämiseksi tiedot on tallennettava volyymiin eikä bind-mountattuun hakemistoon (katso `mongo` kuvan dokumentaatiosta lisätietoja: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Jos haluat tallentaa tiedot MongoDB- ja Redis-konttien sisään liitetyihin Docker-volyymeihin, lisää seuraava kohtaan `config/docker-compose.override.yml` (luo tämä tiedosto, jos sitä ei vielä ole):

{% code title="config/docker-compose.override.yml" %}

```yaml
volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data
```

{% endcode %}

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

</details>

<details>

<summary>Päivitys Redis 6.2:een aiheuttaa uudelleenkäynnistysloopin</summary>

Käytä `docker logs redis` komentoa lokien kopion tulostamiseen.

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

{% code title="Redis-lokin esimerkki" %}

```
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
```

{% endcode %}

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

Lisätietoja, katso Redisin upstream-ongelma: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Malligallerian esikatselu-/pikkukuvien väärä suunta</summary>

Joskus Server Pron luomat esikatselu-/pikkukuvat voivat olla väärässä suunnassa ja vaatia manuaalista korjausta. Nämä kuvat tallennetaan kohtaan `/var/lib/overleaf/data/template_files/` (>= 5.0.3) sekä `/var/lib/sharelatex/data/template_files/` (aiemmin).

Suosittelemme varmuuskopioimaan tämän kansion ennen kuin teet mitään muutoksia.

Sinun on noudatettava alla olevia vaiheita jokaisen vaikutuksen alaisen mallin kohdalla:

Etsi mallin tunnusSiirry instanssisi malligalleriaan (/templates/all), avaa vaikutuksen alainen malli ja kopioi tunnus URL-osoitteesta (esimerkiksi: <https://your-instance-url/templates/6645d346c224815e9460a695).Suorita> korjauskomentoSuorita seuraava komento Docker-isännältä (korvaa mallin tunnus kopioimallasi ja päivitä polku tarvittaessa):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

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

</details>

<details>

<summary>Varmista, että olet ottanut järjestelmäkutsut käyttöön. Pdflatexille tämä on 'pdflatex -shell-escape'.</summary>

Se `\write18` komento on oletusarvoisesti poistettu käytöstä Community Editionissa, koska kaikki käännökset tapahtuvat samassa `sharelatex` kontissa; tämä on turvallisempi oletusasetus.

Jos haluat ottaa sen käyttöön pdflatexille, luo `latexmkrc` tiedosto projektisi juureen seuraavalla sisällöllä:

{% code title="latexmkrc" %}

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

{% endcode %}

Yritä sitten kääntää uudelleen.

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/fi/tuki/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.