以前のバージョンを使用している場合は、パス名の
overleaf の代わりに sharelatex を使用してください。NFS ファイルシステムで Overleaf を実行する
NFS ファイルシステムで Overleaf を実行する
Overleaf コンテナに NFS ファイルシステムをマウントすることは技術的には可能ですが、推奨されません。さまざまな種類のパフォーマンス上のエラーが発生する可能性があります。コンパイル時によく見られるエラーの 1 つは次のとおりです。特に、コンパイルデータ用のディレクトリのような一時的なデータに NFS ベースのファイルシステムを使用することはおすすめしません。以下のディレクトリには、ローカルのスクラッチディスク、できればローカルの SSD を使用することを推奨します。更新後に、既存のファイルを NFS から新しい場所へ移行する必要はありません。LaTeX コンパイラーは、フルコンパイルを再度実行することですべてのファイルを再作成できます。詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
docker-compose ベースの構成では、NFS からのバインドマウントを上書きするだけにすることをおすすめします。これにより、アプリケーション内のパスを変更せずに済みます。以下は、/scratch にマウントされたスクラッチディスクを使用する docker-compose 設定の抜粋例です。docker-compose excerpt
Windows または macOS で Overleaf を実行すると mongo サービスが起動しない
Windows または macOS で Overleaf を実行すると mongo サービスが起動しない
Windows または macOS で Overleaf を実行している場合、これは、Windows でマウントされたディレクトリなど、MongoDB が必要とするセマンティクスを提供しないファイルシステムから MongoDB のデータをバインドマウントした場合に発生することがあります。WSL 2 を使用した Windows では、Toolkit を Ubuntu の Linux ホームディレクトリ以下に置き、デフォルトのバインドマウントを使用してください。プラットフォームガイドの MongoDB の確認項目を参照してください。Docker が管理するストレージが必要な新規インストールの場合は、次のオーバーライドで名前付きボリュームを使用します(MongoDB イメージのストレージに関するガイダンスを参照してください)。既存のインストールでは、マウントを変更してもデータは移行されません。切り替える前にデータベースとキャッシュをバックアップして復元してください。そうしないと、サービスからは空のボリュームが見えることになります。既存の設定とマージしながら、詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
mongo サービスが次のエラーで再起動に失敗することがあります。Example error
config/docker-compose.override.yml に以下を追加してください:config/docker-compose.override.yml
Redis 6.2 にアップグレードすると再起動ループが発生する
Redis 6.2 にアップグレードすると再起動ループが発生する
docker logs redis コマンドを使用してログのコピーを出力します。Fatal: Can't initialize Background Jobs という行が表示される場合、出力全体は次のようになります。Redis log example
Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.
Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.
Community Edition では、すべてのコンパイルが同じ その後、再コンパイルしてみてください。参考: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
sharelatex コンテナ内で行われるため、\write18 コマンドはデフォルトで無効になっています。これはより安全なデフォルト設定です。pdflatex で有効にしたい場合は、プロジェクトのルートに次の内容で latexmkrc ファイルを作成してください。latexmkrc
「Initiating Mongo replica set...」の後に bin/up が unable to upgrade to tcp, received 409 または OCI runtime exec failed で失敗する
「Initiating Mongo replica set...」の後に bin/up が unable to upgrade to tcp, received 409 または OCI runtime exec failed で失敗する
これらのエラーは、よくある原因は次のとおりです。
mongo コンテナがクラッシュと再起動を繰り返していることを意味します。bin/up は MongoDB を起動してからその中でコマンドを実行しますが、コンテナの再起動中にそれが失敗します。bin/docker-compose ps では、mongo サービスが Restarting と表示されます。実際の原因を特定するには、MongoDB のログを確認します。- CPU が AVX に対応していない。MongoDB 5.0 以降は x86-64 で AVX を必要とし、ログには
MongoDB 5.0+ requires a CPU with AVX supportと表示されます。仮想マシンでは、AVX がパススルーされるように CPU タイプをhostに設定してください。 - Linux カーネル 6.19 から 7.0.13。MongoDB はこれらのカーネルでは起動を拒否します。回避策についてはソフトウェア要件を参照してください。
- データが古いバージョンの MongoDB で作成されている。MongoDB 8.0 は 4.4 や 5.0 のデータを直接開くことができません。メジャーバージョンを 1 つずつアップグレードしてください。MongoDB の更新を参照してください。
ログに「Running Overleaf Community Edition, skipping TexLive checks」と表示される
ログに「Running Overleaf Community Edition, skipping TexLive checks」と表示される
これは Ayakaleaf Pro では想定された動作であり、無視してかまいません。このメッセージは
OVERLEAF_IS_SERVER_PRO が true でない場合に出力され、Ayakaleaf Pro のイメージではそれに該当します。Ayakaleaf Pro はこの変数を必要としないため、未設定のままにしてください。コンテナが 910_initiate_doc_version_recovery で停止する、またはコード 2 で終了する
コンテナが 910_initiate_doc_version_recovery で停止する、またはコード 2 で終了する
コンテナは起動のたびに起動スクリプトを順番に実行し、ログにはそれぞれが
*** Running /etc/my_init.d/<script>... として記録されます。910_initiate_doc_version_recovery が処理を行うのは、かつて Overleaf 5.0.1 を実行していたインスタンスだけです。それ以外のインスタンスでは No recovery of doc versions needed. と出力され、起動はそのまま続行されます。その出力は OVERLEAF_DATA_PATH 内の data/history/doc-version-recovery.log にも書き込まれます。終了コードと bin/docker-compose logs --tail=100 sharelatex の末尾から、何が起きたかがわかります:- 終了コード 2 で、ログが
*** Init system aborted.で終わっている場合:bin/stop、docker stop、bin/upでの Ctrl+C などによってコンテナが停止されました。最後のRunning行のスクリプトは、その時点で実行中だったものにすぎず、失敗したわけではありません。bin/up -dでコンテナを再度起動し、起動が完了するまで待ってください。 - 終了コード 1 で、ログに
*** /etc/my_init.d/<script> failed with status <n>と表示されている場合: そのスクリプトが失敗しており、エラーはその直前の行にあります。910_initiate_doc_version_recoveryがDetected unflushed changes while recovering doc versionsで失敗した場合、そのインスタンスは 5.0.1 を実行しており、まだフラッシュされていない編集が残っています。公式の Doc version recovery ガイドに従ってください。
「Restricted, sorry you don’t have permission to load this page」
「Restricted, sorry you don’t have permission to load this page」
このページは、アカウントにログインしているものの、そのページを開く権限がない場合に表示されます。たとえば、管理者ではないアカウントで管理ページを開いた場合や、自分と共有されていないプロジェクトを開いた場合です。管理ページを開くには、管理者アカウントでログインしてください。既存の管理者が別のアカウントを管理者にすることもできますし、
create-user --admin コマンドで管理者アカウントを作成することもできます。ユーザー管理を参照してください。開発環境(develop/)では、管理ページを使うには develop/dev.env に ADMIN_PRIVILEGE_AVAILABLE=true も必要です。Ayakaleaf Pro のイメージではすでに設定されています。
