Sorun Giderme

Daha eski bir sürüm kullanıyorsanız, yol adlarında overleaf yerine lütfen sharelatex kullanın.

Overleaf'i NFS dosya sistemiyle çalıştırma

Bir Overleaf konteynerine NFS dosya sistemi bağlamak teknik olarak mümkündür; ancak önerilmez ve farklı türde performans hatalarına yol açabilir.

Derlemelerde sık görülen hatalardan biri şudur:

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

Özellikle derleme verileri için kullanılan dizinler gibi geçici veriler için NFS tabanlı dosya sistemlerinin kullanılmamasını öneririz. Aşağıdaki dizinler için yerel bir geçici disk, tercihen yerel bir SSD kullanmanızı öneririz.

docker-compose tabanlı kurulumlarda, uygulamadaki yolları değiştirmek zorunda kalmamak için NFS’ten gelen bind-mount’u geçersiz kılmanızı öneririz. Aşağıda /scratch konumuna bağlanmış bir geçici disk kullanan bir docker-compose yapılandırması alıntısı örneği verilmiştir:

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

Güncellemeden sonra mevcut dosyaları NFS’ten yeni konumlarına taşımanıza gerek yoktur. LaTeX derleyicisi, tam bir derleme çalıştırmasıyla tüm dosyaları yeniden oluşturabilir.

Daha fazla ayrıntı için bkz.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Overleaf'i Windows veya macOS üzerinde çalıştırmak mongo hizmetinin başlamamasına neden oluyor

Overleaf’i Windows veya macOS üzerinde çalıştırıyorsanız mongo hizmeti şu hatayla yeniden başlatılamayabilir:

Example error

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

Bu hatayı önlemek için verilerin bind mount ile bağlanmış bir dizin yerine bir birimde (volume) saklanması gerekir (daha fazla ayrıntı için mongo imajı belgelerine bakın: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). Verileri MongoDB ve Redis konteynerlerine bağlanan Docker birimlerinde saklamak için config/docker-compose.override.yml dosyasına aşağıdakileri ekleyin (bu dosya henüz yoksa oluşturun):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - redis-data:/data

Daha fazla bilgi için bkz.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Redis 6.2'ye yükseltme yeniden başlatma döngüsüne neden oluyor

Günlüklerin bir kopyasını çıktı olarak almak için docker logs redis komutunu kullanın.

Fatal: Can't initialize Background Jobs satırını görüyorsanız, tam çıktı aşağı yukarı şöyle görünür:

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

Bu durum, şu anda kullanılan Docker sürümüyle ilgili olabilir. 20.10.10 veya daha yeni bir sürüme güncellemek bu sorunu çözmelidir.

Daha fazla bilgi için Redis’in upstream sorun kaydına bakın: https://github.com/redis/redis/issues/12362

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

Şablon galerisi önizleme/küçük resim görsellerinin yanlış yönlendirmesi

Zaman zaman Server Pro tarafından oluşturulan önizleme/küçük resim görselleri yanlış yönde oluşturulabilir ve düzeltilmeleri için el ile müdahale gerekebilir. Bu görseller /var/lib/overleaf/data/template_files/ (>= 5.0.3) ve /var/lib/sharelatex/data/template_files/ (daha eski sürümler) konumlarında saklanır.

Herhangi bir değişiklik yapmadan önce bu klasörü yedeklemenizi öneririz.

Etkilenen her şablon için aşağıdaki adımları izlemeniz gerekir:

Şablon kimliğini bulunÖrneğinizin şablon galerisine (/templates/all) gidin, etkilenen bir şablonu açın ve URL’deki kimliği kopyalayın (örneğin: https://your-instance-url/templates/6645d346c224815e9460a695).Düzeltme komutunu çalıştırınDocker ana bilgisayarından aşağıdaki komutu çalıştırın (şablon kimliğini kopyaladığınız kimlikle değiştirin ve gerekirse yolu güncelleyin):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

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

Lütfen sistem çağrılarını etkinleştirdiğinizi doğrulayın. pdflatex için bu 'pdflatex -shell-escape' şeklindedir.

Tüm derlemeler aynı sharelatex konteyneri içinde gerçekleştiğinden, Community Edition’da \write18 komutu varsayılan olarak devre dışıdır; bu daha güvenli bir varsayılandır.

pdflatex için etkinleştirmek istiyorsanız, projenizin kök dizininde aşağıdaki içeriğe sahip bir latexmkrc dosyası oluşturun:

latexmkrc

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

Ardından yeniden derlemeyi deneyin.

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