Doctor
Overleaf Toolkitin mukana tulee kätevädoctor-skripti vianmäärityksen avuksi. Suorita bin/doctor, niin skripti tulostaa tietoja isäntäympäristöstäsi, konfiguraatiostasi ja Toolkitin tarvitsemista riippuvuuksista. Tämä tuloste voi myös auttaa meitä diagnosoimaan Ayakaleaf Pro -asennustesi ongelmia.
Overleaf Pron käyttäjät voivat avata issuen GitHubissa.On hyvä idea liittää viestiisi
bin/doctor-skriptin tuloste.Doctorin konsultointi
Suorita doctor-skripti:Run doctor
Esimerkki koko tulosteesta
Esimerkki koko tulosteesta
Isäntäkoneen tiedot
Host Information -osio sisältää tietoja Toolkitia ajavasta koneesta (esimerkiksi Linux-jakelu ja sen versio).
Esimerkki Host Information -tulosteesta
Esimerkki Host Information -tulosteesta
Riippuvuudet
Dependencies-osiossa luetellaan työkalut, joita Toolkit tarvitsee toimiakseen. Jos työkalu on asennettu, se näytetään muodossa status: present versiotietoineen. Jos se puuttuu, se näytetään muodossa status: MISSING!, ja doctor-tulosteen loppuun lisätään varoitus.
Esimerkki Dependency-tulosteesta (asennettu)
Esimerkki Dependency-tulosteesta (asennettu)
Esimerkki Dependency-tulosteesta (puuttuu)
Esimerkki Dependency-tulosteesta (puuttuu)
Konfiguraatio
Configuration-osio sisältää tietoja config/-hakemiston tiedostoista. Tiedostosta config/overleaf.rc doctor tulostaa joitakin keskeisiä arvoja. Puuttuvat tiedostot näytetään muodossa status: MISSING!, ja doctor-tulosteen loppuun lisätään varoitus.
Esimerkki Configuration-tulosteesta
Esimerkki Configuration-tulosteesta
OVERLEAF_DATA_PATH, jonka arvo on/tmp/overleaf, ei välttämättä ole turvallinen sijainti tärkeälle datalle.MONGO_ENABLED: falsetarkoittaa, että Toolkit ei luo omaa MongoDB:tä; varmista tarvittaessa, ettäMONGO_URLosoittaa ulkoisesti hallinnoituun MongoDB:hen.config/variables.envpuuttuu esimerkissä.
Varoitukset
Warnings-osio tiivistää doctor-skriptin havaitsemat ongelmat. Jos ongelmia ei ole, osio ilmoittaa siitä.
Esimerkki Warnings-tulosteesta
Esimerkki Warnings-tulosteesta
Q&A
Pitääkö bin/doctor-komennon quay.io-, Docker-määritys- ja Perl-lokaaliviestit korjata?
Pitääkö bin/doctor-komennon quay.io-, Docker-määritys- ja Perl-lokaaliviestit korjata?
Vastaus: Ei, kaikki kolme ovat vain tiedoksi.
bin/doctor tulostaa ainoastaan raportin, eikä se estä bin/up-komentoa.logged in to quay.io: falseja varoitusServer Pro enabled, but not logged in to quay.io repository: tämä tarkistus on peräisin virallisesta Toolkitista, jossa Server Pro -image on yksityisessä quay.io-rekisterissä. KunSERVER_PRO=true, Toolkit hakee imagenghcr.io/ayaka-notes/overleaf-pro, joka on julkinen, joten kirjautumista ei tarvita. Voit jättää tämän varoituksen huomiotta.grep: /root/.docker/config.json: No such file or directory(tai jokin muu kotihakemisto): quay.io-tarkistus etsii tiedostosta merkkijonoaquay.io. Docker kirjoittaa tiedoston vain, kun sillä on tallennettavia asetuksia, esimerkiksidocker login-komennon jälkeen, joten se puuttuu monilta palvelimilta. Sitä ei tarvita.perl: warning: Setting locale failed: Toolkit käyttääperl-ohjelmaa vain tässä,bin/doctor-komennossa, sen version tulostamiseen, ja Perl varoittaa, kunLANGtaiLC_ALLviittaa lokaaliin, jota ei ole asennettu isäntäkoneelle. Versio tulostetaan silti. Voit vaientaa varoituksen asettamalla nämä muuttujat lokaaliin, jonkalocale -aluettelee, esimerkiksiC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found tai puuttuva tiedosto hakemistossa config/, on sen sijaan korjattava: Toolkit ei käynnisty ilman niitä.
