トラブルシューティング

以前のバージョンを使用している場合は、次を使用してください sharelatex の代わりに overleaf パス名に。

NFSファイルシステムでの Overleaf の実行

Overleaf コンテナに NFS ファイルシステムをマウントすることは技術的には可能ですが、推奨されず、さまざまな種類のパフォーマンスエラーを引き起こす可能性があります。

コンパイル時によく見られる一般的なエラーの一つは次のとおりです:

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

特に、コンパイルデータに使用されるディレクトリのようなエフェメラル（短命）データに対して NFS バッキングのファイルシステムを使用することは避けるよう助言します。これらのディレクトリにはローカルのスクラッチディスク、できればローカル SSD を使用することを推奨します。以下のディレクトリについてです。

について docker-compose ベースのセットアップでは、アプリケーション内のパスを変更せずに NFS からのバインドマウントを上書きすることを提案します。以下は例です、 docker-compose が /scratch にマウントされたスクラッチディスクを使用した設定抜粋です。 /scratch:

docker-compose 抜粋

services:
  sharelatex:
    環境:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    ボリューム:
      - 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

アップデート後に既存のファイルを NFS から新しい場所へ移行する必要はありません。LaTeX コンパイラは完全なコンパイル実行によりすべてのファイルを再作成できます。

詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

Windows または macOS で Overleaf を実行すると `mongo` サービスが起動しない結果になる

Windows または macOS 上で Overleaf を実行している場合、 mongo サービスが再起動に失敗し、次のようなエラーが発生することがあります:

エラーの例

WiredTiger をいずれの互換バージョンでも起動できませんでした。
理由: 1: 操作が許可されていません

このエラーを回避するには、データをバインドマウントされたディレクトリではなくボリュームに保存する必要があります（詳細は mongo イメージのドキュメントを参照してください: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data）。MongoDB と Redis コンテナ内にマウントされた Docker ボリューム内にデータを保存するには、次を追加してください config/docker-compose.override.yml （このファイルがまだ存在しない場合は作成してください）:

config/docker-compose.override.yml

ボリューム:
  mongo-data:
  redis-data:

services:
  mongo:
    ボリューム:
      - mongo-data:/data/db

  redis:
    ボリューム:
      - redis-data:/data

詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

Redis 6.2 へのアップグレードが再起動ループを引き起こす

を使用してください docker logs redis コマンドでログのコピーを出力します。

次の行が表示される場合 Fatal: Can't initialize Background Jobs、完全な出力は次のようになります:

Redis ログの例

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

これは現在使用している Docker のバージョンに関連している可能性があります。バージョンを >= 20.10.10 に更新するとこの問題は解決するはずです。

詳細は Redis のアップストリームの issue を参照してください: https://github.com/redis/redis/issues/12362

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

テンプレートギャラリーのプレビュー/サムネイル画像の向きが正しくない

稀に、Server Pro によって生成されたプレビュー/サムネイル画像が誤った向きで作成され、手動で修正する必要があることがあります。これらの画像は次に保存されています /var/lib/overleaf/data/template_files/ (>= 5.0.3) と /var/lib/sharelatex/data/template_files/ （以前のバージョン）。

変更を加える前にこのフォルダのバックアップを取ることを推奨します。

影響を受ける各テンプレートについて以下の手順に従う必要があります:

テンプレート ID を見つけるインスタンスのテンプレートギャラリー（/templates/all）に移動し、影響を受けるテンプレートを開き、URL から ID をコピーします（例: https://your-instance-url/templates/6645d346c224815e9460a695）。修正コマンドを実行する Docker ホストから次のコマンドを実行してください（テンプレート ID をコピーしたものに置き換え、必要に応じてパスを更新してください）: docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}"

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

システムコールを有効にしていることを確認してください。pdflatex の場合は 'pdflatex -shell-escape' です。

その \write18 コマンドは、すべてのコンパイルが同じ sharelatex コンテナ内で行われるため、Community Edition ではデフォルトで無効になっています；これはより安全なデフォルトです。

pdflatex 用に有効にしたい場合は、プロジェクトのルートに latexmkrc ファイルを作成し、次の内容を記述してください:

latexmkrc

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

その後、再コンパイルを試してください。

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

前へプロジェクトの制限次へヘルプを得る方法

最終更新 1 か月前