> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/fi/tuki/troubleshooting.md).

# Vianmääritys

{% hint style="info" %}
Jos käytät aiempaa versiota, käytä `sharelatex` sen sijaan että `Overleaf` polkunimissä.
{% endhint %}

<details>

<summary>Overleafin ajaminen NFS-tiedostojärjestelmällä</summary>

NFS-tiedostojärjestelmän liittäminen Overleaf-säilöön on teknisesti mahdollista, mutta sitä ei suositella ja se voi aiheuttaa erityyppisiä suorituskykyvirheitä.

Yksi yleinen virhe, jonka kääntäjät näkevät, on:

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

Suosittelemme erityisesti olemaan käyttämättä NFS:ään pohjautuvia tiedostojärjestelmiä tilapäisille tiedoille, kuten käännöstietojen hakemistoille. Suosittelemme käyttämään paikallista scratch-levyä, mieluiten paikallista SSD-levyä seuraaville hakemistoille.

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

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

```yaml
palvelut:
  sharelatex:
    ympäristö:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volyymit:
      - 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 tarvetta siirtää mitään olemassa olevia tiedostoja NFS:ltä uuteen sijaintiin päivityksen jälkeen. LaTeX-kääntäjä voi luoda kaikki tiedostot uudelleen täyden käännöskerran aikana.

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

</details>

<details>

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

Jos ajat Overleafia Windowsissa tai macOS:ssä, `mongo` palvelu ei ehkä käynnisty uudelleen, virheellä:

{% code title="Esimerkkivirhe" %}

```
WiredTigerin käynnistäminen missä tahansa yhteensopivuusversiossa epäonnistui.
Syy: 1: Toiminto ei ole sallittu
```

{% endcode %}

Tämän virheen välttämiseksi tiedot on tallennettava volyymiin bind-mountatun hakemiston sijaan (katso `mongo` kuvadokumentaatiosta lisätietoja varten: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Kun haluat tallentaa tiedot Docker-volyymeihin, jotka on liitetty MongoDB- ja Redis-säilöihin, lisää seuraava kohtaan `config/docker-compose.override.yml` (luo tämä tiedosto, jos sitä ei ole vielä olemassa):

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

```yaml
volyymit:
  mongo-data:
  redis-data:

palvelut:
  mongo:
    volyymit:
      - mongo-data:/data/db

  redis:
    volyymit:
      - 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äivittäminen Redis 6.2:een johtaa käynnistys-silmukkaan</summary>

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

Jos näet rivin `Vakava: Taustatöitä ei voi alustaa`, koko tuloste näyttää jotakuinkin tältä:

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

```
1:M 11 Feb 2024 15:19:22.609 # Palvelin alustettu
1:M 11 Feb 2024 15:19:22.609 # Vakava: Taustatöitä ei voi alustaa.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis käynnistyy 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 varten 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>

Ajoittain Server Pron luomat esikatselu-/pikkukuvat voivat syntyä väärään suuntaan ja vaativat manuaalista korjaamista. Nämä kuvat tallennetaan kohtaan `/var/lib/overleaf/data/template_files/` (>= 5.0.3) ja `/var/lib/sharelatex/data/template_files/` (aiemmat).

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

Sinun on noudatettava alla olevia vaiheita kullekin vaikuttuneelle mallille:

Etsi mallin tunnusSiirry instanssisi malligalleriaan (/templates/all), avaa kyseinen malli ja kopioi tunnus URL-osoitteesta (esimerkiksi: <https://your-instance-url/templates/6645d346c224815e9460a695).Suorita> korjauskomentoSuorita seuraava komento Docker-isännältä (vaihda mallin tunnus kopioimaasi tunnukseen 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>

Kentän `\write18` komento on oletuksena poistettu käytöstä Community Editionissa, koska kaikki käännökset tapahtuvat saman `sharelatex` säilön sisällä; tämä on turvallisempi oletus.

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 %}

Sitten yritä käännöstä 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://overleaf-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.