Doctor
Overleaf Toolkit leveres med et praktiskdoctor-skript som hjelper med feilsøking. Kjør bin/doctor, så skriver skriptet ut informasjon om vertsmiljøet ditt, konfigurasjonen din og avhengighetene Toolkit trenger. Denne utdataen kan også hjelpe oss med å diagnostisere problemer i Ayakaleaf Pro-installasjonene dine.
Brukere av Overleaf Pro kan opprette en issue på GitHub.Det er lurt å inkludere utdataen fra
bin/doctor-skriptet i meldingen din.Konsultere Doctor
Kjør doctor-skriptet:Run doctor
Eksempel på fullstendig utdata
Eksempel på fullstendig utdata
Vertsinformasjon
DelenHost Information inneholder informasjon om maskinen som kjører Toolkit (for eksempel Linux-distribusjon og -versjon).
Eksempel på utdata for Host Information
Eksempel på utdata for Host Information
Avhengigheter
DelenDependencies viser verktøyene som kreves for at Toolkit skal fungere. Hvis et verktøy finnes, vises det som status: present med versjonsinformasjon. Hvis det mangler, vises det som status: MISSING!, og en advarsel legges til nederst i utdataen fra doctor.
Eksempel på utdata for avhengigheter (finnes)
Eksempel på utdata for avhengigheter (finnes)
Eksempel på utdata for avhengigheter (mangler)
Eksempel på utdata for avhengigheter (mangler)
Konfigurasjon
DelenConfiguration inneholder informasjon om filene i katalogen config/. For config/overleaf.rc skriver doctor ut noen sentrale verdier. Manglende filer vises som status: MISSING!, og en advarsel legges til nederst i utdataen fra doctor.
Eksempel på utdata for Configuration
Eksempel på utdata for Configuration
OVERLEAF_DATA_PATHsatt til/tmp/overleafer kanskje ikke et trygt sted for viktige data.MONGO_ENABLED: falsebetyr at Toolkit ikke vil klargjøre sin egen MongoDB; sørg for atMONGO_URLpeker til en eksternt administrert MongoDB ved behov.config/variables.envmangler i eksempelet.
Advarsler
DelenWarnings oppsummerer problemer som doctor-skriptet har oppdaget. Hvis det ikke finnes noen problemer, vil denne delen angi det.
Eksempel på utdata for Warnings
Eksempel på utdata for Warnings
Spørsmål og svar
Må meldingene om quay.io, Docker-konfigurasjon og Perl-lokalitet fra bin/doctor rettes?
Må meldingene om quay.io, Docker-konfigurasjon og Perl-lokalitet fra bin/doctor rettes?
Svar: Nei, alle tre er bare informative.
bin/doctor skriver bare ut en rapport, den stopper ikke bin/up.logged in to quay.io: falseog advarselenServer Pro enabled, but not logged in to quay.io repository: denne kontrollen kommer fra det offisielle Toolkit, der Server Pro-imaget ligger i et privat quay.io-register. MedSERVER_PRO=truehenter Toolkitghcr.io/ayaka-notes/overleaf-pro, som er offentlig, så ingen innlogging er nødvendig. Ignorer denne advarselen.grep: /root/.docker/config.json: No such file or directory(eller en annen hjemmekatalog): quay.io-kontrollen ser etterquay.ioi denne filen. Docker skriver den bare når den har innstillinger å lagre, for eksempel etterdocker login, så den mangler på mange servere. Den er ikke nødvendig.perl: warning: Setting locale failed: Toolkit brukerperlbare her, ibin/doctor, for å skrive ut versjonen, og Perl advarer nårLANGellerLC_ALLangir en lokalitet som ikke er installert på verten. Versjonen skrives likevel ut. For å fjerne advarselen setter du disse variablene til en lokalitet som vises avlocale -a, for eksempelC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found eller en manglende fil i config/ må derimot rettes: Toolkit kan ikke starte uten dem.
