Doktoren
Overleaf Toolkit leveres med et praktiskdoctor-script, der hjælper med fejlfinding. Kør bin/doctor, og scriptet udskriver oplysninger om dit værtsmiljø, din konfiguration og de afhængigheder, som Toolkit har brug for. Dette output kan også hjælpe os med at diagnosticere problemer med dine Ayakaleaf Pro-installationer.
Brugere af Overleaf Pro kan oprette et issue på GitHub.Det er en god idé at inkludere outputtet fra scriptet
bin/doctor i din besked.Konsultation hos doktoren
Kør doctor-scriptet:Run doctor
Eksempel på fuldt output
Eksempel på fuldt output
Værtsoplysninger
AfsnittetHost Information indeholder oplysninger om den maskine, der kører Toolkit (for eksempel Linux-distribution og -udgave).
Eksempel på output for værtsoplysninger
Eksempel på output for værtsoplysninger
Afhængigheder
AfsnittetDependencies viser de værktøjer, der kræves, for at Toolkit kan fungere. Hvis et værktøj er til stede, vises det som status: present med versionsoplysninger. Hvis det mangler, vises det som status: MISSING!, og der tilføjes en advarsel nederst i outputtet fra doctor.
Eksempel på output for afhængigheder (til stede)
Eksempel på output for afhængigheder (til stede)
Eksempel på output for afhængigheder (mangler)
Eksempel på output for afhængigheder (mangler)
Konfiguration
AfsnittetConfiguration indeholder oplysninger om filerne i mappen config/. For config/overleaf.rc udskriver doctor nogle centrale værdier. Manglende filer vises som status: MISSING!, og der tilføjes en advarsel nederst i outputtet fra doctor.
Eksempel på konfigurationsoutput
Eksempel på konfigurationsoutput
OVERLEAF_DATA_PATHsat til/tmp/overleafer muligvis ikke en sikker placering til vigtige data.MONGO_ENABLED: falsebetyder, at Toolkit ikke opretter sin egen MongoDB; sørg for, atMONGO_URLpeger på en eksternt administreret MongoDB, hvis det er nødvendigt.config/variables.envmangler i eksemplet.
Advarsler
AfsnittetWarnings opsummerer de problemer, som doctor-scriptet har fundet. Hvis der ikke er nogen problemer, angiver dette afsnit det.
Eksempel på output for advarsler
Eksempel på output for advarsler
Spørgsmål og svar
Skal meddelelserne om quay.io, Docker-konfiguration og Perl-locale fra bin/doctor rettes?
Skal meddelelserne om quay.io, Docker-konfiguration og Perl-locale fra bin/doctor rettes?
Svar: Nej, alle tre er kun til information.
bin/doctor udskriver blot en rapport; den stopper ikke bin/up.logged in to quay.io: falseog advarslenServer Pro enabled, but not logged in to quay.io repository: dette tjek stammer fra det officielle Toolkit, hvor Server Pro-imaget ligger i et privat quay.io-registry. MedSERVER_PRO=truehenter Toolkitghcr.io/ayaka-notes/overleaf-pro, som er offentligt, så det er ikke nødvendigt at logge ind. Ignorer denne advarsel.grep: /root/.docker/config.json: No such file or directory(eller en anden hjemmemappe): quay.io-tjekket leder efterquay.ioi den fil. Docker skriver den kun, når der er indstillinger at gemme, f.eks. efterdocker login, så den mangler på mange servere. Den er ikke nødvendig.perl: warning: Setting locale failed: Toolkit bruger kunperlher, ibin/doctor, til at udskrive dens version, og Perl advarer, nårLANGellerLC_ALLangiver en locale, der ikke er installeret på værten. Versionen udskrives stadig. For at fjerne advarslen skal du sætte disse variabler til en locale, der vises aflocale -a, f.eks.C.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found eller en manglende fil i config/ skal derimod rettes: Toolkit kan ikke starte uden dem.
