Der Doctor
Das Overleaf Toolkit enthält ein praktischesdoctor-Skript, das bei der Fehlersuche hilft. Führen Sie bin/doctor aus, und das Skript gibt Informationen über Ihre Host-Umgebung, Ihre Konfiguration und die vom Toolkit benötigten Abhängigkeiten aus. Diese Ausgabe kann uns auch helfen, Probleme mit Ihren Ayakaleaf Pro-Installationen zu diagnostizieren.
Nutzerinnen und Nutzer von Overleaf Pro können ein Issue auf GitHub eröffnen.Es empfiehlt sich, die Ausgabe des Skripts
bin/doctor in Ihre Nachricht aufzunehmen.Den Doctor befragen
Führen Sie das Doctor-Skript aus:Run doctor
Beispiel für die vollständige Ausgabe
Beispiel für die vollständige Ausgabe
Host-Informationen
Der AbschnittHost Information enthält Informationen über den Rechner, auf dem das Toolkit läuft (zum Beispiel Linux-Distribution und Release).
Beispiel für die Ausgabe der Host-Informationen
Beispiel für die Ausgabe der Host-Informationen
Abhängigkeiten
Der AbschnittDependencies listet die Werkzeuge auf, die das Toolkit zum Funktionieren benötigt. Ist ein Werkzeug vorhanden, wird es mit status: present und Versionsinformationen aufgeführt. Fehlt es, wird es mit status: MISSING! aufgeführt, und am Ende der doctor-Ausgabe wird eine Warnung hinzugefügt.
Beispiel für die Ausgabe einer Abhängigkeit (vorhanden)
Beispiel für die Ausgabe einer Abhängigkeit (vorhanden)
Beispiel für die Ausgabe einer Abhängigkeit (fehlend)
Beispiel für die Ausgabe einer Abhängigkeit (fehlend)
Konfiguration
Der AbschnittConfiguration enthält Informationen über die Dateien im Verzeichnis config/. Für config/overleaf.rc gibt der Doctor einige wichtige Werte aus. Fehlende Dateien werden mit status: MISSING! aufgeführt, und am Ende der doctor-Ausgabe wird eine Warnung hinzugefügt.
Beispiel für die Ausgabe der Konfiguration
Beispiel für die Ausgabe der Konfiguration
OVERLEAF_DATA_PATHmit dem Wert/tmp/overleafist möglicherweise kein sicherer Speicherort für wichtige Daten.MONGO_ENABLED: falsebedeutet, dass das Toolkit keine eigene MongoDB bereitstellt; stellen Sie bei Bedarf sicher, dassMONGO_URLauf eine extern verwaltete MongoDB verweist.config/variables.envfehlt im Beispiel.
Warnungen
Der AbschnittWarnings fasst die vom Doctor-Skript gefundenen Probleme zusammen. Gibt es keine Probleme, wird dies in diesem Abschnitt angezeigt.
Beispiel für die Ausgabe der Warnungen
Beispiel für die Ausgabe der Warnungen
Q&A
Müssen die Meldungen zu quay.io, zur Docker-Konfiguration und zur Perl-Locale aus bin/doctor behoben werden?
Müssen die Meldungen zu quay.io, zur Docker-Konfiguration und zur Perl-Locale aus bin/doctor behoben werden?
Antwort: Nein, alle drei sind rein informativ.
bin/doctor gibt nur einen Bericht aus und hält bin/up nicht auf.logged in to quay.io: falseund die WarnungServer Pro enabled, but not logged in to quay.io repository: Diese Prüfung stammt aus dem offiziellen Toolkit, bei dem das Server-Pro-Image in einer privaten quay.io-Registry liegt. MitSERVER_PRO=truelädt das Toolkitghcr.io/ayaka-notes/overleaf-pro, das öffentlich ist, sodass keine Anmeldung erforderlich ist. Ignorieren Sie diese Warnung.grep: /root/.docker/config.json: No such file or directory(oder ein anderes Home-Verzeichnis): Die quay.io-Prüfung sucht in dieser Datei nachquay.io. Docker legt sie nur an, wenn Einstellungen zu speichern sind, zum Beispiel nachdocker login, daher fehlt sie auf vielen Servern. Sie wird nicht benötigt.perl: warning: Setting locale failed: Das Toolkit verwendetperlnur hier, inbin/doctor, um dessen Version auszugeben, und Perl warnt, wennLANGoderLC_ALLeine Locale angibt, die auf dem Host nicht installiert ist. Die Version wird trotzdem ausgegeben. Um die Warnung zu unterdrücken, setzen Sie diese Variablen auf eine vonlocale -aaufgeführte Locale, zum BeispielC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found oder eine fehlende Datei in config/ müssen dagegen behoben werden: Ohne sie kann das Toolkit nicht starten.
