The Doctor
Overleaf Toolkit dilengkapi dengan skripdoctor yang praktis untuk membantu proses debugging. Jalankan bin/doctor dan skrip akan mencetak informasi tentang lingkungan host Anda, konfigurasi Anda, dan dependensi yang dibutuhkan Toolkit. Output ini juga dapat membantu kami mendiagnosis masalah pada instalasi Ayakaleaf Pro Anda.
Pengguna Overleaf Pro dapat membuka issue di GitHub.Sebaiknya sertakan output dari skrip
bin/doctor dalam pesan Anda.Berkonsultasi dengan Doctor
Jalankan skrip doctor:Run doctor
Contoh output lengkap
Contoh output lengkap
Informasi Host
BagianHost Information berisi informasi tentang mesin yang menjalankan Toolkit (misalnya, distribusi dan rilis Linux).
Contoh output Host Information
Contoh output Host Information
Dependensi
BagianDependencies mencantumkan alat-alat yang dibutuhkan agar Toolkit dapat berfungsi. Jika sebuah alat tersedia, alat tersebut akan dicantumkan sebagai status: present beserta info versinya. Jika tidak ada, alat tersebut akan dicantumkan sebagai status: MISSING! dan sebuah peringatan akan ditambahkan di bagian bawah output doctor.
Contoh output Dependency (tersedia)
Contoh output Dependency (tersedia)
Contoh output Dependency (tidak ada)
Contoh output Dependency (tidak ada)
Konfigurasi
BagianConfiguration berisi informasi tentang file-file di direktori config/. Untuk config/overleaf.rc, doctor mencetak beberapa nilai penting. File yang tidak ada akan dicantumkan sebagai status: MISSING! dan sebuah peringatan akan ditambahkan di bagian bawah output doctor.
Contoh output Configuration
Contoh output Configuration
OVERLEAF_DATA_PATHyang diatur ke/tmp/overleafmungkin bukan lokasi yang aman untuk data penting.MONGO_ENABLED: falseberarti Toolkit tidak akan menyediakan MongoDB sendiri; pastikanMONGO_URLmengarah ke MongoDB yang dikelola secara eksternal jika diperlukan.config/variables.envtidak ada dalam contoh tersebut.
Peringatan
BagianWarnings merangkum masalah yang ditemukan oleh skrip doctor. Jika tidak ada masalah, bagian ini akan menunjukkannya.
Contoh output Warnings
Contoh output Warnings
Tanya Jawab
Apakah pesan quay.io, konfigurasi Docker, dan locale Perl dari bin/doctor perlu diperbaiki?
Apakah pesan quay.io, konfigurasi Docker, dan locale Perl dari bin/doctor perlu diperbaiki?
Jawaban: Tidak, ketiganya hanya bersifat informatif.
bin/doctor hanya mencetak laporan, dan tidak menghentikan bin/up.logged in to quay.io: falsedan peringatanServer Pro enabled, but not logged in to quay.io repository: pemeriksaan ini berasal dari Toolkit resmi, di mana image Server Pro berada di registry quay.io privat. DenganSERVER_PRO=true, Toolkit menarikghcr.io/ayaka-notes/overleaf-pro, yang bersifat publik, sehingga tidak perlu login. Abaikan peringatan ini.grep: /root/.docker/config.json: No such file or directory(atau direktori home lainnya): pemeriksaan quay.io mencariquay.iodi file tersebut. Docker hanya menulis file itu ketika ada pengaturan yang perlu disimpan, misalnya setelahdocker login, sehingga file ini tidak ada di banyak server. File ini tidak diperlukan.perl: warning: Setting locale failed: Toolkit hanya menggunakanperldi sini, dibin/doctor, untuk mencetak versinya, dan Perl memberi peringatan ketikaLANGatauLC_ALLmenyebut locale yang tidak terinstal di host. Versinya tetap dicetak. Untuk menghilangkannya, atur variabel-variabel ini ke locale yang tercantum olehlocale -a, misalnyaC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found, atau file yang hilang di config/ memang perlu diperbaiki: Toolkit tidak dapat berjalan tanpanya.
