階層型ファイル システムによる添付ファイル ストレージ

ディレクトリ構成

Confluence の添付ファイルには、添付ファイルの元のバージョンのコンテンツ ID という単一の識別属性があります。

たとえば、添付ファイルの元のバージョンがコンテンツ ID 12345678 の場合、バージョン 1、2、6 の添付ファイル名は、それぞれ 12345678.1、12345678.2、12345678.6 になります。

ディレクトリ構造は 5 つのレベルで構成され、各レベルの名前は次のアルゴリズムから派生します。

The modulo calculation is used to find the remainder after division, for example 800 modulo 250 = 50.

#!/bin/sh

content_id=$1
version=1
domain=`expr $content_id % 65535`
folder_1=`expr $domain % 256`
folder_2=`expr $domain / 256`​
​
echo "v4/$folder_1/$folder_2/$content_id/$content_id.$version"

ディレクトリの図

抽出されたテキスト ファイル

テキストベースのファイル (Word、PowerPoint など) が Confluence にアップロードされると、テキストが抽出され、インデックスが作成されます。これにより、ユーザーはファイル名だけでなく、ファイルのコンテンツを検索することができます。この抽出テキストは保存されるため、ファイルのインデックス再作成が必要な場合でも、ファイルのコンテンツを改めて抽出する必要がありません。

抽出されたテキスト ファイルにはコンテンツ ID とバージョン番号を使用した名前が付けられ (例: 12345.2.extracted_text)、ファイル バージョン自体とともに保存されます (上記例のレベル 5 内)。最新バージョンの抽出ファイルのみを保持し、以前のバージョンのファイルは保持されません。 

バージョン 4 への移行

Confluence 8.1 では、添付ファイルを保存するための v4 レイアウト形式が導入されました。以前のバージョン 3 構造から円滑にトランジションできるように、Confluence 8.1 以降へのアップグレード時にこの移行を実施する自動バックグラウンド タスクを追加しています。

移行タスクにより、すべての添付ファイルが ver003 ディレクトリから新しい v4 ディレクトリに移動します。過去にページ移動が失敗して欠落や破損が発生した添付ファイルがこのプロセスで見つかった場合は、すべて復元されます。重複した添付ファイルは、拡張子 .duplicate.X が追加されて保存されます。

このバックグラウンド タスクは、添付ファイル フォルダーに ver003 ディレクトリが存在する場合、Confluence の起動時にのみ実行されます。このプロセス中、Confluence は通常どおり動作します。

移行タスクが完了すると、レポート ファイル v3-to-v4-report.log が添付ファイル ディレクトリに表示されます。移行を実行するたびに新しいレポートが作成されます。レポートには、対応する課題のあるファイルのリストが記載され、移行ステータスが一番下に表示されています。たとえば、正常に完了しました、警告ありで終了しました、中断されました、などです。レポート ファイルには、ログ ファイルが大きくなりすぎないように、正常に移行された添付ファイルは記載されません。

カスタマイズ

These dark feature customizations are available for your migration. To learn how to configure them, see Configuring System Properties.

トラブルシューティング