Pemecahan masalah

Jika Anda menggunakan versi yang lebih lama, gunakan sharelatex alih-alih overleaf pada nama path.

Menjalankan Overleaf dengan sistem file NFS

Me-mount sistem file NFS di kontainer Overleaf secara teknis memungkinkan, tetapi tidak disarankan dan dapat mengakibatkan berbagai jenis masalah performa.

Salah satu error umum yang terjadi saat kompilasi adalah:

EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'

Secara khusus, kami tidak menyarankan penggunaan sistem file berbasis NFS untuk data sementara, seperti direktori yang digunakan untuk data kompilasi. Kami menyarankan penggunaan disk scratch lokal, sebaiknya SSD lokal, untuk direktori-direktori berikut.

Untuk penyiapan berbasis docker-compose, kami menyarankan cukup menimpa bind-mount dari NFS, sehingga tidak perlu mengubah path di aplikasi. Berikut contoh potongan konfigurasi docker-compose yang menggunakan disk scratch yang di-mount di /scratch:

docker-compose excerpt

services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp

Tidak perlu memigrasikan file yang sudah ada dari NFS ke lokasi barunya setelah pembaruan. Compiler LaTeX dapat membuat ulang semua file dengan menjalankan kompilasi penuh kembali.

Untuk detail lebih lanjut, lihat: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Menjalankan Overleaf di Windows atau macOS menyebabkan layanan mongo tidak dapat dijalankan

Jika Anda menjalankan Overleaf di Windows atau macOS, layanan mongo mungkin gagal dimulai ulang, dengan error:

Example error

Failed to start up WiredTiger under any compatibility version.
Reason: 1: Operation not permitted

Untuk menghindari error ini, data perlu disimpan di volume, bukan di direktori bind mount (lihat dokumentasi image mongo untuk detail lebih lanjut: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Untuk menyimpan data di dalam volume Docker yang di-mount di dalam kontainer MongoDB dan Redis, tambahkan yang berikut ke config/docker-compose.override.yml (buat file ini jika belum ada):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data

Untuk informasi lebih lanjut, lihat: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Upgrade ke Redis 6.2 menyebabkan restart loop

Gunakan perintah docker logs redis untuk menampilkan salinan log.

Jika Anda melihat baris Fatal: Can't initialize Background Jobs, output lengkapnya akan terlihat seperti ini:

Redis log example

1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo

Hal ini mungkin terkait dengan versi Docker yang sedang digunakan. Memperbarui ke versi >= 20.10.10 seharusnya dapat menyelesaikan masalah ini.

Untuk informasi lebih lanjut, lihat issue upstream Redis: https://github.com/redis/redis/issues/12362

Referensi: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop

Orientasi gambar pratinjau/thumbnail galeri templat yang salah

Terkadang, gambar pratinjau/thumbnail yang dihasilkan oleh Server Pro dapat dibuat dengan orientasi yang salah dan memerlukan intervensi manual untuk memperbaikinya. Gambar-gambar ini disimpan di /var/lib/overleaf/data/template_files/ (>= 5.0.3) dan /var/lib/sharelatex/data/template_files/ (versi sebelumnya).

Kami menyarankan untuk mem-backup folder ini sebelum melakukan perubahan apa pun.

Anda perlu mengikuti langkah-langkah di bawah ini untuk setiap templat yang terpengaruh:

Temukan ID templatBuka galeri templat instans Anda (/templates/all), buka templat yang terpengaruh, dan salin ID dari URL (misalnya: https://your-instance-url/templates/6645d346c224815e9460a695).Jalankan perintah koreksiJalankan perintah berikut dari host Docker (ganti ID templat dengan yang Anda salin dan perbarui path jika perlu):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

Referensi: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images

Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.

Perintah \write18 dinonaktifkan secara default di Community Edition karena semua kompilasi terjadi di dalam kontainer sharelatex yang sama; ini adalah default yang lebih aman.

Jika Anda ingin mengaktifkannya untuk pdflatex, buat file latexmkrc di root proyek Anda dengan konten berikut:

latexmkrc

$pdflatex = 'pdflatex --shell-escape';

Lalu coba kompilasi ulang.

Referensi: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape