Siirry pääsisältöön
Jos käytät aiempaa versiota, käytä polkujen nimissä sharelatex-nimeä overleaf-nimen sijaan.
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:
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
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
Jos ajat Overleafia Windowsissa tai macOS:ssä, mongo-palvelun uudelleenkäynnistys voi epäonnistua virheellä:
Example error
Tämä voi tapahtua, kun MongoDB:n data on bind-mount-liitetty tiedostojärjestelmästä, joka ei tarjoa sen vaatimaa toimintaa, kuten Windowsista liitetystä hakemistosta. Windowsissa WSL 2:n kanssa pidä Toolkit Ubuntun Linux-kotihakemiston alla ja käytä oletusarvoisia bind-liitoksia. Katso alustaoppaan MongoDB-tarkistukset.Jos uusi asennus tarvitsee Dockerin hallinnoimaa tallennustilaa, seuraava override käyttää nimettyjä volyymeja (katso MongoDB-imagen tallennusohjeet). Olemassa olevassa asennuksessa liitosten muuttaminen ei siirrä dataa: varmuuskopioi ja palauta tietokanta/välimuisti ennen vaihtamista, tai palvelu näkee tyhjät volyymit. Lisää tämä tiedostoon config/docker-compose.override.yml yhdistäen sen olemassa oleviin määrityksiin:
config/docker-compose.override.yml
Lisätietoja: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
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
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/12362Lähde: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Joskus Ayakaleaf 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/.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
\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
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
Nämä virheet tarkoittavat, että mongo-kontti kaatuu ja käynnistyy jatkuvasti uudelleen. bin/up käynnistää MongoDB:n ja ajaa sitten sen sisällä komennon, joka epäonnistuu kontin käynnistyessä uudelleen. bin/docker-compose ps näyttää mongo-palvelun tilana Restarting.Selvitä varsinainen syy lukemalla MongoDB:n loki:
Yleisiä syitä ovat:
  • Suorittimessa ei ole AVX-tukea. MongoDB 5.0 ja uudemmat vaativat AVX:n x86-64-arkkitehtuurilla, ja lokissa näkyy MongoDB 5.0+ requires a CPU with AVX support. Aseta virtuaalikoneessa suoritintyypiksi host, jotta AVX välitetään virtuaalikoneelle.
  • Linux-ydin 6.19–7.0.13. MongoDB kieltäytyy käynnistymästä näillä ytimillä. Katso kiertotapa kohdasta Ohjelmistovaatimukset.
  • Data on luotu vanhemmalla MongoDB-versiolla. MongoDB 8.0 ei voi avata version 4.4 tai 5.0 dataa suoraan. Päivitä yksi pääversio kerrallaan, katso MongoDB:n päivittäminen.
Tämä on odotettua Ayakaleaf Prossa, ja voit jättää sen huomiotta. Viesti tulostetaan, kun OVERLEAF_IS_SERVER_PRO ei ole true, mikä pätee Ayakaleaf Pro -imagessa. Ayakaleaf Pro ei tarvitse tätä muuttujaa, joten jätä se asettamatta.
Ennen kuin Overleaf käynnistyy, kontti suorittaa käynnistystarkistukset ja sammuu, jos jokin niistä epäonnistuu. Toolkit ajaa sitä asetuksella restart: always, joten Docker käynnistää sen uudelleen ja sama tarkistus epäonnistuu taas. Käynnistystuloste kertoo, mikä tarkistus epäonnistui:
Yleisiä syitä ovat:
  • Missing required secrets: aseta OVERLEAF_INVITE_TOKEN_SECRET tiedostoon config/variables.env, katso Ympäristömuuttujat.
  • ShareLaTeX to Overleaf rebranding: määrityksissä käytetään yhä SHARELATEX_-muuttujia tai -polkuja; nimeä ne uudelleen viestin ohjeiden mukaisesti.
  • Virhe kohdan Checking can connect to mongo and redis jälkeen: Overleaf ei tavoita MongoDB:tä tai Redisiä. Tarkista bin/logs mongo ja bin/logs redis.
Kun syy on korjattu, suorita bin/up -d.
Jokaisella käynnistyskerralla kontti ajaa käynnistysskriptinsä peräkkäin, ja loki nimeää jokaisen muodossa *** Running /etc/my_init.d/<script>.... 910_initiate_doc_version_recovery tekee työtä vain instansseissa, joissa on joskus ajettu Overleaf 5.0.1:tä. Kaikissa muissa instansseissa se tulostaa No recovery of doc versions needed. ja käynnistys jatkuu. Sen tuloste menee myös tiedostoon data/history/doc-version-recovery.log hakemistossa OVERLEAF_DATA_PATH.Poistumiskoodi ja komennon bin/docker-compose logs --tail=100 sharelatex tulosteen loppu kertovat, mitä tapahtui:
  • Poistumiskoodi 2, ja loki päättyy riviin *** Init system aborted.: kontti pysäytettiin esimerkiksi komennolla bin/stop, docker stop tai painamalla Ctrl+C komennon bin/up aikana. Viimeisellä Running-rivillä mainittu skripti on vain se, joka oli käynnissä sillä hetkellä, eikä se epäonnistunut. Käynnistä kontti uudelleen komennolla bin/up -d ja anna käynnistyksen valmistua.
  • Poistumiskoodi 1, ja lokissa näkyy *** /etc/my_init.d/<script> failed with status <n>: kyseinen skripti epäonnistui, ja sen virhe on juuri sitä edeltävillä riveillä. Jos 910_initiate_doc_version_recovery epäonnistui virheeseen Detected unflushed changes while recovering doc versions, instanssissa on ajettu 5.0.1:tä ja siinä on yhä tallentamattomia muokkauksia; noudata virallista Doc version recovery -ohjetta.
Tämä sivu näytetään, kun tilisi on kirjautunut sisään mutta sillä ei ole lupaa avata sivua, esimerkiksi kun ylläpitosivun avaa tili, joka ei ole ylläpitäjä, tai kun projektia ei ole jaettu kanssasi.Avataksesi ylläpitosivut kirjaudu sisään ylläpitäjätilillä. Olemassa oleva ylläpitäjä voi tehdä toisesta tilistä ylläpitäjän, tai voit luoda sellaisen komennolla create-user --admin, katso Käyttäjien hallinta. Kehitysympäristössä (develop/) ylläpitosivut edellyttävät lisäksi asetusta ADMIN_PRIVILEGE_AVAILABLE=true tiedostossa develop/dev.env; Ayakaleaf Pro -image asettaa sen valmiiksi.
Viimeksi muokattu 8. marraskuuta 2026