OCCを使用してNextcloudのメンテナンスモードを安全に解除します。

アップデートまたはメンテナンス作業後も Nextcloud に「メンテナンスモード」と表示される場合は、まずデータベースのアップグレードが完了しているかどうかを確認してください。occ statusと表示された場合はneedsDbUpgrade: false、occ maintenance:mode --off正しい Nextcloud インストール環境で Web サーバーユーザーとして を実行してください。 と表示された場合はtrue、occ upgradeサイトを再度開く前に を完了してください。

フラグを無効にするとログインは復元されますが、失敗したアップグレードは修復されません。最終的な目標は、メンテナンスフラグとアップグレード状態の両方が検証された状態でインスタンスをオンラインに戻すことです。

1. インスタンスの状態を変更する前に、インスタンスの状態を確認してください。

影響を受ける N​​extcloud URL を提供するホストまたはコンテナに接続します。Linux に手動でインストールした場合は、Nextcloud ディレクトリ (多くの場合/var/www/nextcloud) に移動し、HTTP ユーザーとしてステータスを確認します。

cd /var/www/nextcloud
sudo -E -u www-data php occ status

maintenanceとを探してくださいneedsDbUpgrade。無効化しても安全な状態は、maintenance: trueの場合ですneedsDbUpgrade: false。メンテナンスが既に false の場合、ブラウザは古いページを表示しているか、別のバックエンドにアクセスしている可能性があります。 がneedsDbUpgradetrue の場合は、メンテナンスモードをまだオフにしないでください。

Nextcloudでは、ファイルの所有権を一定に保つため、OCCをHTTPユーザーとして実行する必要があります。DebianまたはUbuntuでは通常www-data、HTTPユーザーとして実行されますが、他のディストリビューションではapache、 HTTP http、HTTP、HTTPユーザーなどが使用される場合があります。コマンドでユーザーを置き換える前に、インストール先のサービスアカウントを確認してください。Nextcloud OCCのwwwrun最新ドキュメントには、ユーザーの違いとステータスコマンドが記載されています。

2. OCCでメンテナンスモードを無効にする

アーカイブまたはパッケージをインストールする場合は、適切なスクリプトが含まれているディレクトリからコマンドを実行してくださいocc。

sudo -E -u www-data php occ maintenance:mode --off

このコマンドは、メンテナンスモードが無効になっていることを報告する必要があります。この--offオプションはメンテナンス状態を変更するものであり、移行の実行、権限の修正、中断されたファイル置換の取り消しなどは行いません。

インストール環境に合ったラッパーを使用してください。公式のNextcloud Dockerイメージの場合、プロジェクトドキュメントにはdocker execDocker Composeの例も含まれています。サンプルコンテナ名またはサービス名を、ご自身のものに置き換えてください。

# Docker Compose; "app" is an example service name
docker compose exec --user www-data app php occ maintenance:mode --off

# Docker; replace CONTAINER_ID with the Nextcloud container
docker exec -it --user www-data CONTAINER_ID php occ maintenance:mode --off

Nextcloud Snapの場合、Snapの内部ディレクトリに入るのではなく、ホスト側のOCCラッパーを使用してください。

sudo nextcloud.occ maintenance:mode --off

Snapプロジェクトで/snap/bin/nextcloud.occは、そのディレクトリがシェルのPATHに含まれていない場合に必要になる可能性があると注意書きがあります。Snapのメンテナンスモードの手順を参照してください。Nextcloudの公式DockerイメージのREADMEには、コンテナコマンドのパターンが記載されています。

3. アップグレードがまだ保留中の場合は、まずそれを完了してください。

ステータスレポートでエラーが発生した場合needsDbUpgrade: true、Nextcloud はコードとデータベースの移行が同期していないことを示しています。これは通常、アップデーターがコードを置き換えたものの、移行フェーズが完了しなかった場合に発生します。この状態では、使用できる OCC コマンドが制限される場合があり、アップグレード中にユーザーがアクセスできないように、メンテナンスモードが意図的に有効になっている場合があります。

インストールタイプに応じたアップグレードパスを使用し、続行する前にアップデーターのエラーを確認してください。標準のアーカイブベースのインストールの場合、目的のNextcloudコードバージョンが存在することを確認し、まだバックアップがない場合は新しいデータベースとファイル/設定のバックアップを取得した後、以下を実行します。

sudo -E -u www-data php occ upgrade

コマンドが完了し、報告されたエラーが解決されるまで待ちます。移行エラーを回避するために、メンテナンスモードを繰り返し切り替えないでください。Nextcloudのアップグレードに関するドキュメントには、データベースの移行はサーバーコードの置き換え後に行われると説明されており、アップグレード前に最新のバックアップを作成することが推奨されています。Docker、Snap、およびマネージドパッケージには独自のアップグレード手順がある場合があります。アーカイブベースの例と異なる場合は、それらの手順を使用してください。

アップグレードが正常に完了し、ステータスにデータベースのアップグレード保留中と表示されなくなったら、maintenance:mode --off上記の適切なコマンドを実行してください。config.phpデータベースの編集や直接更新をショートカットとして使用しないでください。OCC が設定を書き込めない場合は、正しいインストールと HTTP ユーザーを選択したことを確認し、アクセス許可を変更する前に、読み取り専用構成ポリシーまたはファイルシステムアクセス許可のエラーがないか確認してください。

4. フラグとライブサイトを確認する

同じインストールパス、コンテナ、ユーザーを使用して、再度ステータスを実行します。

sudo -E -u www-data php occ status

maintenance: falseとの両方を確認してくださいneedsDbUpgrade: false。Docker または Snap では、フラグを無効にするために使用したのと同じラッパーを使用してチェックを繰り返します。Nextcloud のステータス コマンドはこれらのフィールドを文書化します。機械可読形式は ですocc status --output=json_pretty。

次に、新しいブラウザタブでサイトを再読み込みし、通常のログインとファイル一覧表示をテストしてください。Nextcloud は、メンテナンスモードになる前にログインしていたユーザーは、サーバーがオンラインに戻った後にブラウザを更新する必要がある場合があると述べています。OCC がメンテナンスが false であると報告しているにもかかわらず、サイトにメンテナンスページが表示される場合は、ホスト名またはロードバランサーが変更したインスタンスと同じインスタンスにルーティングされていることを確認してください。複数のコンテナまたはノードを使用している場合、別のバックエンドがまだメンテナンスモードになっている可能性があります。

したがって、修正が成功したとは、単に「無効」コマンドの応答が表示されるだけではありません。OCC ステータスで両方のフラグがクリアされていること、そして意図したパブリック URL で正常に動作するインスタンスが提供されていることが条件となります。アップグレードフラグが有効なままの場合、または移行コマンドが失敗した場合は、ユーザーを接続せず、Nextcloud を再度開く前にアップグレードエラーを解決してください。