ownCloud 10のMySQL接続障害のトラブルシューティング

ownCloud 10 で「データベースへの接続に失敗しました」と表示された場合は、まず MySQL にアクセスできない、アカウントが拒否されている、または PHP ドライバが不足しているかどうかを確認してください。ownCloud に保存されているデータベース サービスと正確なホスト名、データベース名、ユーザー名を確認しconfig/config.php、権限を変更したり、何かを再作成したりする前に、ownCloud サーバーからこれらの認証情報をテストしてください。このガイドは、MySQL または MariaDB を使用する ownCloud Server 10.16 を対象としています。メニュー ラベルとパッケージ コマンドは、オペレーティングシステムとインストール方法によって異なる場合があります。

エラーが何を示しているのかを理解する

「データベース接続失敗」は一般的なメッセージです。ownCloudログまたはWebサーバーログに表示される、より具体的なMySQLまたはPHPのエラーが原因を示している場合がほとんどです。MySQLエラー2002や2003などの接続エラーは、一般的にサービスが停止している、ソケットまたはポートが間違っている、ネットワークパスがブロックされている、またはownCloudが想定する場所でサーバーがリッスンしていないことを示しています。「アクセス拒否」メッセージは通常、MySQLが接続を受信したが、そのユーザー名、パスワード、またはクライアントホストを受け入れなかったことを意味します。

MySQLはデータベースサーバーを意味します。MariaDBはownCloudがサポートする互換性のあるデータベースオプションです。PDO MySQLは、ownCloudがどちらのデータベースサーバーとも通信できるようにするPHPデータベースドライバです。対処法:すべての接続失敗をパスワードの誤りとして扱うのではなく、正確なエラーテキストとタイムスタンプをメモし、以下のチェック項目と照合してください。

設定を変更する前に準備してください。

  • ownCloudとMySQLが同じマシン上で動作しているのか、異なるマシン上で動作しているのか、あるいは別々のコンテナ内で動作しているのかを確認してください。
  • ownCloudのインストールパス、データベースホスト、ポートまたはソケット、データベース名、および専用データベースのユーザー名を把握しておいてください。
  • 管理者セッションまたはコンソールアクセスを常に利用できる状態にしておいてください。config/config.php編集する前に必ずバックアップを取り、サポートリクエストにデータベースのパスワードを記載しないでください。
  • 必要な場合にのみ、管理者権限でコマンドを実行してください。例に挙げた名前とパスは、ご自身のインストール環境における値に置き換えてください。

初期トラブルシューティング手順としてデータベースを削除したり再作成したりしないでください。既存のユーザーファイルとメタデータはデータベースに依存しています。対処方法:データベースレベルの変更を行う前に、ownCloudデータディレクトリとデータベースの両方の検証済みバックアップを作成してください。

データベースサービスと接続パスを確認してください。

  1. MySQLまたはMariaDBが実行されていることを確認してください。systemd Linuxホストでは、システムにインストールされている名前を使用してサービスを調べます。
sudo systemctl status mysql
sudo systemctl status mariadb

お使いのディストリビューションにサービス名が存在しない可能性があります。サービスが停止している場合は、再起動する前に、ジャーナルとデータベースのエラーログを調べて原因を特定してください。対処方法: ownCloudの認証情報のトラブルシューティングを行う前に、ディスク容量不足や無効なデータベース構成などの起動エラーを解決してください。

  1. ownCloudマシンからホストとポートを確認してください。データベースホストとポート(通常は3306)へのTCP接続をテストしてください。リモートデータベースの場合は、名前解決、ファイアウォールルール、およびMySQLがownCloudサーバーからアクセス可能なインターフェースでリッスンしていることを確認してください。ポート3306をインターネットに広く公開しないでください。
  2. localhostソケットの違いを理解してください。Unix系システムでは、接続するMySQLクライアントはlocalhost多くの場合ローカルUnixソケットを使用しますが、127.0.0.1TCPを強制します。これは、データベースがローカルにあるにもかかわらず、PHPとMySQLが異なるソケットパスを使用している場合に重要になります。対処法:ソケットパスとホスト設定をデータベースサーバーの実際の構成と比較するか、意図したパスがTCPである場合は意図的にTCPをテストしてください。

ownCloudサーバーから、ownCloudが使用するのと同じデータベースユーザー名、ホスト名、データベース名を使用してログインテストを行います。

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

プロンプトにパスワードを入力してください。コマンドに直接入力すると、シェル履歴に保存される可能性があります。ローカルソケット接続の場合は、代わりに構成に一致するホストとソケットモードをテストしてください。ログインが成功すると、MySQLがその接続パスとアカウントを受け入れることが証明されますが、PHPにドライバがあることやownCloudが同じ設定を読み取っていることは証明されません。対処方法:このコマンドが失敗した場合は、MySQLのエラーを使用して次のチェックを選択してください。

ownCloudの設定、PHPドライバー、および権限を確認してください。

ownCloud のインストール ウィザードは、データベースの種類、データベース名、ユーザー名、パスワード、ホスト、テーブル プレフィックスを に書き込みますconfig/config.php。パスワードをログやチャットにコピーせずに、値を注意深く確認してください。 にはdbhostホストとポートが含まれる場合があります。 と表示されている場合はlocalhost、想定されるソケットが PHP プロセスで使用可能かどうかを確認してください。

コマンドラインクライアントは正常に動作するのにownCloudが依然として失敗する場合は、Webサーバーで使用されているPHPランタイムがpdo_mysqlインストールされ、有効になっていることを確認してください。などのシェルコマンドはphp -mCLI PHPランタイムのみを報告するため、ApacheやPHP-FPMとは異なる場合があります。対処方法:アクティブなWeb PHP構成を確認し、拡張機能を有効にした後、関連するWeb/PHPサービスを再起動してください。

「アクセス拒否」の場合は、MySQL に、データベースが認識しているユーザー名とクライアント ホストの両方に一致するアカウントが存在するかどうかを確認してください。MySQL は、などのアカウントを別個のものとして扱います'oc_user'@'localhost'。ownCloud'oc_user'@'10.0.0.5'アプリがコンテナ内にある場合、データベースはではなく、コンテナ アドレスまたはブリッジ アドレスを認識する可能性がありますlocalhost。対処方法:データベース管理者に、一致するアカウントと権限を調べてもらい、アクセスが必要な ownCloud ホストまたはネットワークからのみアクセスを許可してください。

データベースが存在し、ownCloudアカウントがそれを使用できることを確認してください。グローバル権限を付与したり、ownCloudでMySQLのrootアカウントを使用したりすることは避けてください。必要な権限は、新規インストールか既存インスタンスかによって異なります。対処方法: ownCloudの該当段階のデータベース設定ガイドに従い、無関係なデータベースの所有権や権限を変更しないでください。

修正を適用し、修正内容を確認します。

テストで特定された設定のみを修正してください。データベースサービスを開始する、到達可能なホスト名とポートを使用する、ソケットの不一致を修正する、PHPドライバを有効にする、アカウントのパスワードを修正する、またはホスト固有のデータベース権限を調整するなどです。編集する場合はconfig/config.php、有効なPHP構文を維持し、最初にバックアップを作成してください。データベース名、テーブルプレフィックス、または認証情報を推測で変更しないでください。

変更後、ownCloud をリロードし、データベース接続警告なしでページが読み込まれることを確認してください。ownCloud のログでリクエストが成功したことを確認し、ユーザーが既存のファイルを参照できることを確認してください。MySQL が接続拒否ではなく「サーバーが応答しなくなりました」と報告する場合は、接続の切断またはタイムアウト、あるいはパケットサイズの問題など、別の問題が発生している可能性があります。ownCloud では、その場合の MySQL タイムアウトとパケットサイズの設定について説明しています。対処方法:該当するデータベースのトラブルシューティング手順に従い、ログで診断結果が裏付けられている場合にのみサーバー制限を変更してください。

ownCloudの現在のServer 10.16のドキュメントでは、通常のデータベース設定にはインストールウィザードの使用を推奨しており、特にpdo_mysqlMySQLソケットパスの確認項目として挙げています。パッケージ名、PHPバージョン、サービス名はホストによって異なります。対処方法: ownCloudサーバーから接続テストを再度実行し、アプリケーションが既存のデータを読み取れることを確認してください。

公式資料

コメントを残す

ownCloud 10のMySQL接続障害のトラブルシューティング

mySQL、PHP、ソケット設定、またはデータベース権限がownCloud 10の動作を妨げているかどうかを確認し、安全な修正方法を検証してください。

ownCloudの公開リンクに厳格な有効期限を設定する

ownCloudの公開リンクに厳格な有効期限を設定する

ownCloud Classicで公開リンクの有効期限を必須に設定し、最大有効期間を設定し、別途クリーンアップが必要な既存の共有フォルダを確認してください。

keycloakを使用してownCloud Infinite ScaleにTOTP二要素認証ログインを追加する

keycloakを使用してownCloud Infinite ScaleにTOTP二要素認証ログインを追加する

Keycloak経由でTOTPを有効にし、ユーザーを安全に登録し、Infinite ScaleのルートレベルのMFA設定が適用されるタイミングを理解します。

ownCloudの同期を復元するには、クライアントをサーバーに一致させてください。

問題がOC10と7.xの互換性の問題なのか、それともCSyncジャーナルの破損なのかを確認し、同期済みファイルを削除せずに適切な修正を適用してください。

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

HTTP-01またはDNS-01を選択し、ownCloudリバースプロキシを設定して、CertbotがHTTPS証明書を自動的に更新することを確認してください。

ownCloud Infinite ScaleをLDAPに接続してユーザーサインインを行う

展開前に、oCIS LDAPサインインを設定し、ユーザーとグループのルックアップを整合させ、TLSとスキーマの設定を確認してください。

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にAmazon S3バケットを追加し、互換性のある認証情報とエンドポイントを準備し、マウントとプライマリストレージを混同することなくアクセスを確認します。

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloud Server の保護された MariaDB ダンプをスケジュールし、メンテナンスモードを安全に処理し、各バックアップに依存する前に検証します。

サポート対象の移行を使用してownCloud ClassicをoCISに移行する

ownCloud 10からoCISへの移行を計画する際は、サポート対象のアプリ、順序付けられたコマンド、本人確認、および個別に処理する必要のあるデータの明確なリストを用意してください。

テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Classic 10のロゴを置き換え、テーマアプリを使用してWeb UIの色を調整し、アップグレードや整合性チェックの落とし穴を回避します。