適切なバックエンドを使用してownCloudのファイルロックタイムアウトを解消する

ownCloudがファイルロックのタイムアウトを報告した場合、データベースのロック行をすぐに削除したり、ロックを無効にしたりしないでください。まず、メッセージがファイル操作中のトランザクションロックに関するものか、有効期限付きのユーザー作成WebDAVロックに関するものかを判断してください。トランザクションロックのタイムアウトが繰り返し発生する場合、負荷の高いサーバーでは、ロックキャッシュをデータベースからRedisに移動するのが現実的な解決策となることが多いです。トラフィックの少ない環境では、データベースバックエンドが正常であれば、そのまま使用しても問題ありません。

どのロックがタイムアウトしているかを特定します。

トランザクションファイルロックは、 ownCloudがアップロード、同期、移動、その他の変更を処理する際にファイルを保護します。これはデフォルトで有効になっており、ロックキャッシュが設定されていない限り、ロックはデータベースに保存されます。そのため、データベースの処理速度が遅かったり、負荷が高かったりすると、ファイル操作が遅延する可能性があります。ownCloud Server 10.16のガイダンスでは、データベースの負荷を軽減するために、外部トランザクションロックにRedisを使用することを推奨しています。

手動によるファイルロックは異なります。手動ロックでは、ユーザーが意図的にファイルをロックして他のユーザーによる変更を防止します。WebDAV ロック機能では、有効期限が適用されます。ownCloud Server 10.16 では、管理者がデフォルトおよび最大タイムアウトを設定し、ロック解除グループを定義できます。対処方法:修正を適用する前に、ログメッセージ、影響を受けるファイル、およびユーザーがロックインジケーターを確認しているかどうかを使用して、原因を特定してください。

MySQLの「ロック待機タイムアウト超過」のようなメッセージは、ユーザーロックの期限切れではなく、データベーストランザクションが別のトランザクションを待機していることを示している可能性があります。同様に、「Redisが応答しなくなった」というメッセージは、古いファイルではなく、Redisの接続性の問題を示しています。対処法: ownCloudログとデータベース/Redisログを同じタイムスタンプで確認してください。すべての「ロック」エラーを同じ問題として扱わないでください。

サーバーに適したバックエンドを選択してください

状況実用的な選択トレードオフ
プライベートな低トラフィックのホームサーバーデータベースの状態を調査している間は、データベースのロックを維持してください。管理するサービスは少なくなるが、ロック操作によってデータベースの作業量が増える。
ビジーなシングルサーバーRedisをロック用に設定する。利用可能な場合は、ローカルキャッシュにAPCuを使用する。データベースへのロック負荷を軽減しますが、RedisとそのPHP拡張機能は引き続き利用可能である必要があります。
複数のアプリケーションサーバーすべてのウェブノードからアクセス可能な共有Redisエンドポイントを使用する共通ロックキャッシュをサポートし、Redisのネットワークアクセス、認証、可用性が運用上の依存関係となる。

ownCloudのドキュメントによると、Memcachedはトランザクションファイルロックに必要な永続的なロック動作を提供しないため、memcache.lockingMemcachedを設定しないでください。この役割にはRedisがサポートされています。対処方法:分散キャッシュに既にMemcachedを使用している場合は、その機能を分離し、ロック専用にRedisを設定してください。

ownCloudを変更する前にRedisを確認してください

Redisがインストールされ、実行中で、PHPウェブワーカーからアクセス可能であり、ネットワーク設計に従って保護されていることを確認してください。PHP Redis拡張機能もウェブランタイムから利用可能である必要があります。コマンドラインPHPのみをチェックしても、ApacheまたはPHP-FPMが同じ拡張機能を使用していることを証明できない場合があります。ローカルRedisインスタンスの場合、ownCloudのドキュメントではTCPまたはUnixソケットのどちらかをサポートしています。クラスタでは、すべてのアプリケーションノードが同じRedisロックサービスを指す必要があり、個別のローカルRedisデータベースを指すことはできません。

config/config.php編集を行う前に、既存のローカルまたは分散キャッシュ設定をバックアップし、メモしておいてください。ルーチンの最初のステップとして、Redisデータベース全体をフラッシュしないでください。Redisの共有方法によっては、無関係なキャッシュデータやセッションが消去される可能性があります。対策:メンテナンスを行う前に、Redisデータベースのインデックスと、他のアプリケーションがそのRedisインスタンスを使用しているかどうかを確認してください。

Redisでトランザクションロックを設定する

以下のエントリをに追加またはマージしてくださいconfig/config.php。重複するPHP配列キーは作成せず、既存のエントリを更新してください。この例では、同じホスト上のTCP経由のRedisを使用しています。

'filelocking.enabled' => true,
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
    'host' => '127.0.0.1',
    'port' => 6379,
    'timeout' => 0,
    'password' => 'replace-with-your-redis-secret',
    'dbindex' => 0,
],

デプロイメントに合わせて、Redis のホスト、ポート、パスワード、データベースインデックス、ソケットパスを使用してください。Redis は信頼できるローカルまたはプライベートネットワークのクライアントのみに制限し、公開しないでください。Unix ソケットの場合、ownCloud の例ではソケットパスを として使用しhost、portに設定しています0。Web サーバーユーザーは、そのソケットにアクセスする権限を持っている必要があります。

インストール構成プロセスで必要な場合にのみ、関連するPHP/Webサービスを再起動または再読み込みしてください。その後、管理画面の概要とownCloudログでキャッシュまたはロックの例外がないか確認してください。対策:変更が完了したと判断する前に、テストアカウントを使用して少量のアップロード、名前変更、および同期操作をテストしてください。

問題が手動ロックのタイムアウトである場合

ユーザーが作成したロックの有効期間が長すぎる場合は、[設定] > [管理者] > [一般]occの [手動ファイルロック] 設定を確認してください。ownCloud 10.16 では、WebDAV ロックのデフォルトおよび最大有効期間を設定するための以下の例が記載されています。

sudo -u www-data ./occ config:app:set files lock_timeout_default --value 1800
sudo -u www-data ./occ config:app:set files lock_timeout_max --value 86400

これらの値は秒単位です。例のデフォルト値はすべてのポリシーに必須ではありません。ユーザーがロックを保持する必要のある適切な期間を選択してください。完全に放棄されたロックの場合、ロックの所有者はファイルの詳細ビューからロックを解除できる場合があります。管理者はロック解除グループを設定することもできます。対処方法: WebDAV ロックレコードを直接編集するのではなく、サポートされている UI/API またはグループベースの復旧パスを使用することをお勧めします。

修正内容を確認し、危険な近道は避けてください。

変更後、アップロードと同期操作が完了していること、同時編集によってファイルが破損していないこと、ログにロックバックエンドのタイムアウトが繰り返し発生していないことを確認してください。ログにRedis接続エラーが表示される場合は、Redisの可用性、認証情報、拡張機能の読み込み、またはソケットの権限を修正してください。エラーの原因を理解せずに設定を何度も変更すると、根本原因が隠蔽される可能性があります。

タイムアウトを解消するためにトランザクションロックを無効にしないでください。トランザクションロックはファイル操作を保護するものであり、これを削除すると同時実行時に整合性の問題が発生する可能性があります。ownCloud のサポートドキュメントで、該当する障害について指示されている場合を除き、ロックテーブルからデータベース行を削除したり、共有 Redis データベースをフラッシュしたりしないでください。対処方法:構成済みのバックエンドとその健全性を確認しても問題が解決しない場合は、タイムスタンプ付きの ownCloud およびバックエンドのログを取得し、管理者と連携して、遅いデータベースクエリまたはロック競合について調査してください。

公式資料

コメントを残す

適切なバックエンドを使用してownCloudのファイルロックタイムアウトを解消する

データベースロックの競合と期限切れのWebDAVロックを区別し、適切なownCloud 10の修正プログラムを選択して設定します。

ownCloud Webを開くと空白ページが表示される場合の確認事項

ownCloud Webを開くと空白ページが表示される場合の確認事項

ownCloudのWeb画面が空白になる原因を、ブラウザのキャッシュ、Webアセットの欠落、サービスエラー、またはリバースプロキシのURL設定など、特定のチェック項目に絞り込んで特定します。

ownCloud PHPメモリ警告を正しい実行時にクリアする

ownCloudのWeb PHPメモリ制限を設定し、該当するサービスを再起動し、CLI設定やアップロード制限と混同しないように注意しながら、有効な値を確認してください。

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バケットを追加し、互換性のある認証情報とエンドポイントを準備し、マウントとプライマリストレージを混同することなくアクセスを確認します。