Confluence ホームおよびその他の重要なディレクトリ
Confluence インストール ディレクトリ
'Confluence インストールディレクトリ' は、Confluence がインストールされたディレクトリです。
インストールディレクトリ内の重要なファイル:
bin/setenv.batまたはbin/setenv.sh
このファイルは CATALINA_OPTS のメモリやガベージ コレクション設定を編集し、システム プロパティを定義するために使用されます。confluence/WEB-INF/classes/confluence-init.properties
このファイルには Confluence ホーム ディレクトリの場所が含まれます。
On this page:
Confluence ホームディレクトリ
Confluence のホーム ディレクトリとは、Confluence がその構成情報、検索用インデックス、およびページの添付ファイルを保存するフォルダです。"ホーム ディレクトリ" の別名は "data ディレクトリ" です。Data Center では "ローカル ホーム ディレクトリ" とも呼ばれます。
ホームディレクトリを見つける
Confluence ホーム ディレクトリの場所は、 Confluence のインストール時に定義されます。この場所は confluence-init.properties ファイルに保存されます。このファイルは、Confluence インストール ディレクトリの confluence/WEB-INF/classes ディレクトリ内にあります。
Confluence の稼働時にホーム ディレクトリの場所を見つけるには、[管理] 
> [一般設定] > [システム情報] > [Confluence 情報 - Confluence ホーム] に移動します。
Confluence Data Center (クラスタ化されたインスタンス) を使用している場合、共有ホーム ディレクトリもあります。ここには、クラスタ化が行われない場合はホーム ディレクトリ内に常駐する、一部のデータ (添付ファイルおよびバックアップ) が含まれます。共有ホーム ディレクトリの場所は、<local-home>/confluence.cfg.xml ファイルの confluence.cluster.home プロパティで見つけることができます。
ホームディレクトリのコンテンツ
Confluence ホームディレクトリには、Confluence によって利用される構成データの一部が含まれています。このセクションは、Confluence ホームディレクトリにおけるファイルおよびディレクトリの目的を概説します。
| ファイルまたはディレクトリ | 目的 |
|---|---|
| このファイルには、Confluence をスタートアップする際に必要となる、次のようなあらゆる情報が含まれています:
|
| このディレクトリには、Confluence に保存されている各添付ファイルのあらゆるバージョンが含まれています。
Data Center では、このディレクトリは通常、共有ホーム ディレクトリにあります。 S3 オブジェクト ストレージが設定されている場合、このディレクトリは使用されません。 |
| Confluence は日次のバックアップ アーカイブと手動で生成されたすべてのバックアップをこのディレクトリに保管します。このディレクトリ内のバックアップ ファイルは、次のような形式になります:
Data Center では、このディレクトリは通常、共有ホーム ディレクトリにあります。 |
| Confluence には一連のプラグインが同梱されます。bundled-plugins ディレクトリは、Confluence が起動時にバンドル プラグインを保存する場所です。このディレクトリは再起動時に必ずリフレッシュされるため、このディレクトリからプラグインを削除してもそのプラグインのアンインストールが行われるわけではありません。変更内容は、Confluence の次回の起動時に置き換えられます。 |
| これは、組み込みの H2 データベースを使用して Confluence を実行する設定にした場合に、データベースが保存される場所です。そのような場合、このディレクトリには全ての Confluence ランタイムデータが含まれます。MySQL 等の外部データベースを利用して実行するよう構成されているインストレーションは、このディレクトリを使用しません。 H2 データベースは Confluence を評価するために提供されており、本番用データベースとしてはサポートされていません。 |
| Confluence インデックスは、コンテンツの検索や最近更新されたリストのためにアプリケーションによって頻繁に使用され、Confluence インスタンスを稼働するために不可欠です。このディレクトリのデータが失われたり、破損したりした場合、Confluence 内から完全インデックス再作成を実行することで復元できます。このプロセスは、Confluence のデータベースに保存されているデータの量によっては、かなりの時間を要する場合があります。
|
journal/ | エントリは、変更が生じる (コメント、いいね、新規ページなど) とジャーナルに追加されます。次に、ジャーナルエントリが処理され、インデックスに追加されます (約 5 秒ごと)。クラスター構成では、ジャーナルは各ノードでインデックスを同期して維持します。 |
logs/ | Confluence のアプリケーションログはこのディレクトリに保存されます。 |
| すべての Confluence プラグインはデータベースに保存されます。プラグイン JAR 内に含まれるクラスに素早くアクセスできるよう、Confluence は plugin-cache ディレクトリ内にそれらのプラグインをキャッシュします。このディレクトリは、プラグインがシステムからインストール / アンインストールされるたびに更新され、Confluence が再起動されるたびにデータベースから完全に取り込まれます。このディレクトリからプラグインを削除しても、それらのアンインストールが行われるわけではありません。 |
|
必要に応じて、別の一時ディレクトリの場所を指定できます。 |
| 画像サムネイル用に一時ファイルを保存します。このディレクトリは、基本的にサムネイルキャッシュで、このディレクトリから削除されたファイルは、次に画像にアクセスしたときに再生成されます。 Data Center では、このディレクトリは通常、共有ホーム ディレクトリにあります。 |
shared-home/ | このサブディレクトリは、Confluence Server のインストール時にホーム ディレクトリに作成されます。Data Center に移動することを選択した場合は、このディレクトリのコンテンツを別の共有ホーム ディレクトリ (すべてのノードからアクセス可能なもの) に移動します。 Office ドキュメントや PDF プレビューなどの一部の機能のキャッシュ ファイルも、(Server と Data Center の両方で) このディレクトリに保存されます。 |
ホームディレクトリのロケーションの変更
Confluence は初回の起動時に confluence-init.properties ファイルを読み、ホーム ディレクトリを探す場所を確認します。
ホーム ディレクトリの場所を変更するには、confluence-init.properties ファイルで confluence.home プロパティを次のように編集します。
- Windows
Windows では、パスC:\confluence\dataは次のように表記されます。confluence.home=C:/confluence/data
すべてのバックスラッシュ (\) がフォワードスラッシュ (/) として表記されることにご注意ください。 - Linux
Linux ベースのシステムでは、プロパティは通常のディレクトリ構文によって定義されます。confluence.home=/var/confluence/
シンボリックリンク
Confluence ホーム ディレクトリ内にシンボリック リンクを配置することはできません。ユーザーは絶対パスを定義する必要があります。ディスク スペースに問題がある場合、confluence.home ディレクトリ全体を十分なスペースがあるディスク パーティションに配置します。生成されたファイル(エクスポートなど) の絶対パスは、URL 構築時に confluence.home ディレクトリの絶対パスと比較されます。サブディレクトリが別のパスを持つ場合、URL は誤りと見なされ、"ページが見つかりません" というエラー メッセージが表示される場合があります。これらは、ディレクトリ トラバーサル攻撃を防止するための対策です。
Confluence 設定の修正
ホーム ディレクトリ内の Confluence 設定ファイル confluence-cfg.xml には、Confluence ホームの元の場所への参照が含まれている場合があります。このファイルを編集してこれらの参照を更新し、新しい場所をポイントするようにする必要があります。このファイルの次の 2 つのプロパティを変更する必要があります。
daily.backup.dir: バックアップを他の場所に配置するように構成していない場合hibernate.connection.url: 組み込みの HSQL データベースを使用している場合
データベース
ページ コンテンツを含むその他のすべてのデータがデータベースに保持されます。Confluence をトライアルとしてインストールした場合、またはセットアップ中に組み込みの H2 データベースを使用することを選択した場合、データベース ファイルは Confluence ホーム ディレクトリの database/ に保存されます。それ以外の場合、接続しているデータベース管理システムによって残りのデータの保存先と方法が決定されます。
一時ディレクトリ (インストール ディレクトリ)
The temp directory in the installation directory is set by CATALINA_TMPDIR. This is different from the Java runtime temp directory. However, the java.io.tempDir defaults to CATALINA_TMPDIR. You can change its location by following these steps:
1. Create the temporary directory
The directory should be on the local disk for optimal performance, have sufficient free space, and allow all necessary permissions to the user starting the Confluence process.
- Create a new directory where you want to move the
tmpdir. - Ensure that the user running the Confluence process has full access to this directory. You can set the permissions using the following commands:
$ chown -R confluence <new-tmpdir-path>
$ chmod -R u=rwx,go-rwx <new-tmpdir-path>2. Customize the setenv.sh file
- To customize the
java.io.tmpdirpath, edit the<CONFLUENCE_INSTALLATION_DIR>/bin/setenv.shfile. - Add or update the following line below the
JVM_SUPPORT_RECOMMENDED_ARGS:
CATALINA_TMPDIR='/your/custom/path/here'If a CATALINA_TMPDIR line already exists, update it instead of adding a new line.
3. Confluence を再起動します。
- Restart Confluence to apply the changes and start using the new
tmpdir. - If you are running a Data Center cluster, perform a rolling restart one node at a time.