Doktorn
Overleaf Toolkit levereras med ett praktisktdoctor-skript som hjälper till vid felsökning. Kör bin/doctor så skriver skriptet ut information om din värdmiljö, din konfiguration och de beroenden som Toolkit behöver. Utdata kan också hjälpa oss att diagnostisera problem i dina Ayakaleaf Pro-installationer.
Användare av Overleaf Pro kan skapa ett ärende på GitHub.Det är en bra idé att inkludera utdata från skriptet
bin/doctor i ditt meddelande.Rådfråga doktorn
Kör doctor-skriptet:Run doctor
Exempel på fullständig utdata
Exempel på fullständig utdata
Värdinformation
AvsnittetHost Information innehåller information om maskinen som kör Toolkit (till exempel Linux-distribution och version).
Exempel på utdata för värdinformation
Exempel på utdata för värdinformation
Beroenden
AvsnittetDependencies listar de verktyg som krävs för att Toolkit ska fungera. Om ett verktyg finns listas det som status: present med versionsinformation. Om det saknas listas det som status: MISSING! och en varning läggs till längst ner i utdata från doctor.
Exempel på utdata för beroenden (finns)
Exempel på utdata för beroenden (finns)
Exempel på utdata för beroenden (saknas)
Exempel på utdata för beroenden (saknas)
Konfiguration
AvsnittetConfiguration innehåller information om filerna i katalogen config/. För config/overleaf.rc skriver doktorn ut några viktiga värden. Saknade filer listas som status: MISSING! och en varning läggs till längst ner i utdata från doctor.
Exempel på utdata för konfiguration
Exempel på utdata för konfiguration
OVERLEAF_DATA_PATHsatt till/tmp/overleafär kanske inte en säker plats för viktiga data.MONGO_ENABLED: falseinnebär att Toolkit inte tillhandahåller en egen MongoDB; se vid behov till attMONGO_URLpekar på en externt hanterad MongoDB.config/variables.envsaknas i exemplet.
Varningar
AvsnittetWarnings sammanfattar problem som doctor-skriptet har upptäckt. Om det inte finns några problem anges det i det här avsnittet.
Exempel på utdata för varningar
Exempel på utdata för varningar
Frågor och svar
Behöver meddelandena om quay.io, Docker-konfigurationen och Perl-locale från bin/doctor åtgärdas?
Behöver meddelandena om quay.io, Docker-konfigurationen och Perl-locale från bin/doctor åtgärdas?
Svar: Nej, alla tre är enbart informativa.
bin/doctor skriver bara ut en rapport, den stoppar inte bin/up.logged in to quay.io: falseoch varningenServer Pro enabled, but not logged in to quay.io repository: den här kontrollen kommer från den officiella Toolkit, där Server Pro-imagen ligger i ett privat quay.io-register. MedSERVER_PRO=truehämtar Toolkitghcr.io/ayaka-notes/overleaf-pro, som är offentlig, så ingen inloggning behövs. Ignorera den här varningen.grep: /root/.docker/config.json: No such file or directory(eller en annan hemkatalog): quay.io-kontrollen letar efterquay.ioi den filen. Docker skriver den bara när det finns inställningar att spara, till exempel efterdocker login, så den saknas på många servrar. Den behövs inte.perl: warning: Setting locale failed: Toolkit använderperlbara här, ibin/doctor, för att skriva ut dess version, och Perl varnar närLANGellerLC_ALLanger en locale som inte är installerad på värden. Versionen skrivs ändå ut. Om du vill tysta varningen anger du dessa variabler till en locale som listas avlocale -a, till exempelC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found eller en saknad fil i config/ behöver däremot åtgärdas: Toolkit kan inte starta utan dem.
