はじめに
Nextcloudのアップグレードは、新機能の追加やセキュリティパッチの適用に不可欠ですが、時として失敗することがあります。
本記事ではアップグレード失敗について簡単にまとめました。
対象読者
- Nextcloud管理者
- アップグレードに不安を感じている方
- 実際にアップグレードに失敗した方
目次
1. アップグレード失敗の典型的な症状
症状1: 白い画面
画面が真っ白で何も表示されない
ログインページすら表示されない
原因の可能性
- PHPのメモリ不足
- 権限の問題
- 壊れたファイル
症状2: メンテナンスモードから抜けられない
原因の可能性
- アップグレードプロセスの中断
- データベース移行の失敗
- タイムアウト
症状3: 500 Internal Server Error
原因の可能性
- Apacheまたはnginxの設定エラー
- PHPエラー
- データベース接続の問題
症状4: データベースエラー
原因の可能性
- データベーススキーマの移行失敗
- データベース破損
- 権限不足
症状5: アプリの互換性エラー
原因の可能性
- サードパーティアプリの非互換性
- アプリの依存関係の問題
2. 失敗する主な原因
技術的要因
| 原因 | 頻度 | 深刻度 |
|---|---|---|
| PHPバージョン不適合 | 高 | 高 |
| データベースの問題 | 中 | 高 |
| ディスク容量不足 | 中 | 中 |
| メモリ不足 | 高 | 中 |
| 権限の問題 | 中 | 中 |
| タイムアウト | 中 | 低 |
手順的要因
- バックアップの未実施
- アップグレード手順のスキップ
- 段階的アップグレードの無視（例: 28→32を直接実行）
- メンテナンスウィンドウの不足
環境的要因
- 本番環境での直接アップグレード
- 負荷の高い時間帯での実施
- 同時に複数の変更を実施
3. 復旧前の初動対応
ステップ1: パニックにならない
焦って操作すると状況が悪化します
ステップ2: 現状の記録
現在の状態をスクリーンショットまたはテキストで保存
エラーメッセージを記録
実施した操作を時系列で記録
記録すべき情報
- エラーメッセージ
- 実施したコマンド
- アップグレード前後のバージョン
- 発生時刻
ステップ3: ログの確認
Nextcloudログ、Webサーバーログ、PHPログ、システムログ
ステップ4: サービスの停止
ユーザーアクセスを遮断（これ以上の被害を防ぐ）
sudo systemctl stop nginx またはapache
ステップ5: バックアップの確認
バックアップの存在確認
4. 復旧手順：パターン別
パターンA: メンテナンスモードから抜けられない
復旧手順
方法1: config.phpの編集
以下を探して変更
’maintenance’ => true,
↓
’maintenance’ => false,
保存して終了
Webサーバー再起動
方法2: occ コマンド
メンテナンスモード解除
sudo -u www-data php /var/www/nextcloud/occ maintenance:mode –off
アップグレードを再実行
sudo -u www-data php /var/www/nextcloud/occ upgrade
方法3: データベース直接操作（最終手段）
– MySQLの場合
mysql -u nextcloud -p nextcloud
UPDATE oc_appconfig
SET configvalue = ‘false’
WHERE appid = ‘core’ AND configkey = ‘maintenance’;
EXIT;
→アクセス確認
パターンB: PHPエラー
PHPエラーログの確認
復旧手順
ステップ1: PHPバージョンの確認
現在のPHPバージョン
php -v
ステップ2: PHPメモリ制限の引き上げ
php.iniの編集
以下を変更
memory_limit = 512M # 元の値（例:128M）から引き上げ
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
Webサーバー再起動
ステップ3: 権限の修正
権限の再設定
PHPの設定確認
php -i | grep memory_limit
→アクセス確認
パターンC: アプリ互換性エラー
無効化されたアプリの確認
復旧手順
ステップ1: 問題のあるアプリの特定
アップグレードログから非互換アプリを確認
ステップ2: アプリの無効化
個別に無効化
sudo -u www-data php /var/www/nextcloud/occ app:disable problematic_app
全サードパーティアプリを無効化（最終手段）
ステップ3: アップグレード再実行
sudo -u www-data php /var/www/nextcloud/occ upgrade
ステップ4: アプリの更新と再有効化
アプリの更新確認
sudo -u www-data php /var/www/nextcloud/occ app:update –all
個別に有効化
sudo -u www-data php /var/www/nextcloud/occ app:enable app_name
パターンD: ディスク容量不足
ディスク使用状況の確認
df -h
復旧手順
ステップ1: 空き容量の確保
不要なログファイルの削除
古いバックアップの削除
ステップ2: 古いバージョンファイルの削除
アップグレード時のバックアップディレクトリを削除
パターンE: 完全復元
どんな時に？
- 複数の問題が複合的に発生
- 復旧に数時間以上かかる見込み
- 原因が特定できない
完全復元手順
ステップ1: 完全バックアップの準備確認
必要なバックアップ
- データベース
- Nextcloudファイル
- config.php
ステップ2: 現在の状態をバックアップ（念のため）
失敗状態でもバックアップ
ステップ3: データベースの復元
ステップ4: ファイルの復元
ステップ5: サービス再起動
ステップ6: 動作確認
→アクセス確認
5. 予防策とベストプラクティス
アップグレード前のチェックリスト
必須項目
□ 完全バックアップの実施
- データベース
- Nextcloudファイル
- config.php
- カスタムアプリ
□ バックアップの動作確認
- テスト環境での復元テスト
□ ディスク容量の確認
- 空き容量が全体の20%以上
□ PHPバージョンの確認
- 新バージョンの要件を満たしているか
□ アプリの互換性確認
- Nextcloud App Storeで確認
□ メンテナンス時間の確保
- 最低2時間のメンテナンスウィンドウ
□ ユーザーへの事前通知
- 最低24時間前に通知
□ ドキュメントの準備
- 公式アップグレードガイドの確認
- ロールバック手順の確認
推奨項目
□ テスト環境での事前検証
□ 段階的アップグレード計画
□ 失敗時の連絡フロー確認
トラブルシューティングチートシート
1. バージョン確認
sudo -u www-data php /var/www/nextcloud/occ -V
2. ステータス確認
sudo -u www-data php /var/www/nextcloud/occ status
3. メンテナンスモード確認
grep maintenance /var/www/nextcloud/config/config.php
4. ディスク容量確認
df -h
5. メモリ使用状況
free -h
6. データベース接続確認
sudo -u www-data php /var/www/nextcloud/occ db:check
7. アプリ一覧
sudo -u www-data php /var/www/nextcloud/occ app:list
よくあるエラーと対処法
| エラーメッセージ | 原因 | 対処法 |
|---|---|---|
| maintenance mode is enabled | メンテナンスモード | occ maintenance:mode –off |
| SQLSTATE[42S02] | テーブル不存在 | DBバックアップから復元 |
| Allowed memory size exhausted | PHPメモリ不足 | php.iniでmemory_limit引き上げ |
| 502 Bad Gateway | PHP-FPMダウン | systemctl restart php-fpm |
| Permission denied | 権限不足 | chown -R |
まとめ: 安全なアップグレードの鉄則
絶対に守るべき3原則
１.必ずバックアップを取る
- ファイル、データベース、設定ファイル
- バックアップの動作確認も実施
２.段階的にアップグレードする
- メジャーバージョンを飛ばさない
- 各段階で動作確認
３.テスト環境で検証する
- 本番と同じ環境で事前検証
- 所要時間の測定
失敗時の心構え
- パニックにならず、冷静に状況を記録
- バックアップがあれば復旧可能
- サポートに相談(お待ちしております！)
継続的改善
- 毎回のアップグレードで手順を改善
- ドキュメント化して共有
- 自動化できる部分は自動化
参考リソース
公式ドキュメント
- Nextcloud Upgrade Guide: https://docs.nextcloud.com/server/latest/admin_manual/maintenance/upgrade.html
- Nextcloud Release Notes: https://nextcloud.com/changelog/
おわりに
最後に最も重要なこと
バックアップなしにアップグレードするべからず