> 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/on-premises-no/stotte/troubleshooting.md).

# Feilsøking

{% hint style="info" %}
Hvis du bruker en tidligere versjon, bruk `sharelatex` i stedet for `Overleaf` i banenavn.
{% endhint %}

<details>

<summary>Kjører Overleaf med et NFS-filsystem</summary>

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

En vanlig feil som kompileringer ser 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 bare å overstyre bind-mounten fra NFS, noe som unngår å endre stier i programmet. Her er et eksempel på en `docker-compose` konfigurasjonsutdrag med bruk av en scratch-disk som er montert på `/scratch`:

{% code title="utdrag fra docker-compose" %}

```yaml
tjenester:
  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 %}

Det er ikke nødvendig å migrere noen eksisterende filer fra NFS til deres nye plassering etter oppdateringen. LaTeX-kompilatoren kan gjenskape alle filene med en fullstendig kompileringskjøring igjen.

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

</details>

<details>

<summary>Kjøring av Overleaf på Windows eller macOS fører til at `mongo`-tjenesten ikke starter</summary>

Hvis du kjører Overleaf på Windows eller macOS, kan `mongo` tjenesten mislykkes i å starte på nytt, med en feil:

{% code title="Eksempel på feil" %}

```
Kunne ikke starte WiredTiger under noen kompatibilitetsversjon.
Årsak: 1: Operasjonen er ikke tillatt
```

{% endcode %}

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

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

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

tjenester:
  mongo:
    volumes:
      - mongo-data:/data/db

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

{% endcode %}

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

</details>

<details>

<summary>Oppgradering til Redis 6.2 resulterer i en omstartsløkke</summary>

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

Hvis du ser linjen `Fatal: Kan ikke initialisere bakgrunnsjobber`, vil den fulle utgangen se omtrent slik ut:

{% code title="Eksempel på Redis-logg" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server initialisert
1:M 11 Feb 2024 15:19:22.609 # Fatal: Kan ikke initialisere bakgrunnsjobber.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis starter oO0OoO0OoO0Oo
```

{% endcode %}

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

For mer informasjon, se Redis' upstream-problem: <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>

</details>

<details>

<summary>Feil orientering på forhåndsvisnings-/miniatyrbilde for temagalleri</summary>

Ved enkelte tilfeller kan forhåndsvisnings-/miniatyrbildene som genereres av Server Pro, bli opprettet i feil orientering og kreve manuell inngripen for å korrigeres. Disse bildene lagres i `/var/lib/overleaf/data/template_files/` (>= 5.0.3) og `/var/lib/sharelatex/data/template_files/` (tidligere).

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

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

Finn mal-IDenNaviger til instansens temagalleri (/templates/all), åpne en berørt mal, og kopier ID-en fra URL-en (for eksempel: <https://your-instance-url/templates/6645d346c224815e9460a695).Kjør> korrigeringskommandoenKjør følgende kommando fra Docker-verten (erstatt mal-ID-en med den du kopierte og oppdater stien hvis det er passende):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>

</details>

<details>

<summary>Vennligst bekreft at du har aktivert systemkall. For pdflatex er dette 'pdflatex -shell-escape'.</summary>

Den `\write18` -kommandoen er deaktivert som standard i Community Edition, fordi alle kompileringer skjer innenfor den samme `sharelatex` containeren; dette er den tryggere standardinnstillingen.

Hvis du vil aktivere det for pdflatex, opprett en `latexmkrc` fil i rotkatalogen til prosjektet ditt med følgende innhold:

{% code title="latexmkrc" %}

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

{% endcode %}

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>

</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/on-premises-no/stotte/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.