Confluence インストール ディレクトリ

The 'Confluence Installation directory' is the directory where Confluence was installed. This directory is also sometimes called the 'Confluence Install directory'. Confluence does not modify or store any data in this directory. 

インストールディレクトリ内の重要なファイル:

  • bin/setenv.bat または bin/setenv.sh
    このファイルは CATALINA_OPTS のメモリやガベージ コレクション設定を編集し、システム プロパティを定義するために使用されます。 
  • confluence/WEB-INF/classes/confluence-init.properties
    このファイルには Confluence ホーム ディレクトリの場所が含まれます。 

On this page:

Confluence ホームディレクトリ

Confluence ホームディレクトリとは、Confluence がその構成情報、検索用インデックス、およびページ添付ファイルを保存するフォルダです。評価目的に提供された組み込みデータベースである HSQLDB を利用している場合、データベースファイルもこのディレクトリ内に保存されます。「ホームディレクトリ」の別名は、「データディレクトリ」です。

ホームディレクトリを見つける

Confluence ホーム ディレクトリの場所は、 Confluence のインストール時に定義されます。この場所は confluence-init.properties ファイルに保存されます。このファイルは、Confluence インストール ディレクトリの confluence/WEB-INF/classes ディレクトリ内にあります。 

When Confluence is running you can find the location of the home directory in  > General Configuration > System Information > Confluence Information - Confluence Home.

Confluence インスタンスがクラスター化されている場合、共有ホームディレクトリもあります。ここには、クラスター化されていなければホームディレクトリに存在する一部のデータ (添付ファイルおよびバックアップ) があります。

ホームディレクトリのコンテンツ

Confluence ホームディレクトリには、Confluence によって利用される構成データの一部が含まれています。このセクションは、Confluence ホームディレクトリにおけるファイルおよびディレクトリの目的を概説します。

ファイルまたはディレクトリ目的

confluence.cfg.xml

このファイルには、Confluence をスタートアップする際に必要となる、次のようなあらゆる情報が含まれています:

  • 製品ライセンス
  • コンテキストパス
  • ロケーションおよび接続プール設定等のデータベースに関する詳細
  • 重要なディレクトリへのパス

attachments/

このディレクトリには、Confluence に保存されている各添付ファイルのあらゆるバージョンが含まれています。 

confluence.cfg.xml で attachments.dir プロパティを設定することで、添付ファイルの保存場所の代替ディレクトリを指定できます。

backups/

Confluence は日次のバックアップ アーカイブと手動で生成されたすべてのバックアップをこのディレクトリに保管します。このディレクトリ内のバックアップ ファイルは、次のような形式になります: daily-backup-YYYY_MM_DD.zip。

confluence.cfg.xml で daily.backup.dir プロパティを設定することで、バックアップの代替ディレクトリを指定できます。

bundled-plugins/

Confluence には一連のプラグインが同梱されます。bundled-plugins ディレクトリは、Confluence が起動時にバンドル プラグインを保存する場所です。このディレクトリは再起動時に必ずリフレッシュされるため、このディレクトリからプラグインを削除してもそのプラグインのアンインストールが行われるわけではありません。変更内容は、Confluence の次回の起動時に置き換えられます。 

database/

This is where Confluence stores its database when configured to run with the embedded HSQL database. In such cases this directory contains all Confluence runtime data. Installations configured to run using an external database such as MySQL will not use this directory.

The HSQL database is provided for evaluating Confluence and is not supported as a production database. 

index/

Confluence インデックスは、コンテンツの検索や最近更新されたリストのためにアプリケーションによって頻繁に使用され、Confluence インスタンスを稼働するために不可欠です。このディレクトリのデータが失われたり、破損したりした場合、Confluence 内から完全インデックス再作成を実行することで復元できます。このプロセスは、Confluence のデータベースに保存されているデータの量によっては、かなりの時間を要する場合があります。

confluence.cfg.xml で lucene.index.dir プロパティを設定することで、インデックス用の代替ディレクトリを指定できます。 

plugin-cache/

すべての Confluence プラグインはデータベースに保存されます。プラグイン JAR 内に含まれるクラスに素早くアクセスできるよう、Confluence は plugin-cache ディレクトリ内にそれらのプラグインをキャッシュします。このディレクトリは、プラグインがシステムからインストール / アンインストールされるたびに更新され、Confluence が再起動されるたびにデータベースから完全に取り込まれます。このディレクトリからプラグインを削除しても、それらのアンインストールが行われるわけではありません。

resources/

The resources directory stores any space logos used in your Confluence instance.  Space logos are stored in directories named with the spacekey. 

temp/

temp ディレクトリは、エクスポート、インポート、ファイル アップロード、インデックス作成などのランタイム機能に使用されます。このディレクトリのファイルは一時ファイルで、Confluence がオフラインのときに安全に削除できます。Confluence 内の日次ジョブが、不要になったファイルを削除します。

An alternative directory may be specified for temporary data by setting the webwork.multipart.saveDir property in confluence.cfg.xml.

thumbnails/

画像サムネイル用に一時ファイルを保存します。このディレクトリは、基本的にサムネイルキャッシュで、このディレクトリから削除されたファイルは、次に画像にアクセスしたときに再生成されます。

 

ホームディレクトリのロケーションの変更

Confluence は初回の起動時に confluence-init.properties ファイルを読み、ホーム ディレクトリを探す場所を確認します。 

ホーム ディレクトリの場所を変更するには、confluence-init.properties ファイルで confluencee.home プロパティを次のように編集します。

  • Windows
    Windows では、パス C:\confluence\data は次のように表記されます。
    confluence.home=C:/confluence/data  
    すべてのバックスラッシュ (\) がフォワードスラッシュ (/) として表記されることにご注意ください。
  • Linux / Solaris
    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 データベースを使用している場合

データベース

All other data, including page content, is kept in the database. If you have configured Confluence to use the embedded HSQL database, the database will store its files under database/ in the Confluence Home Directory. Otherwise, the database management system you are connecting to is responsible for where and how your remaining data is stored.

一時ディレクトリ

一時ディレクトリは Java ランタイムで設定され、一部の Confluence コンポーネントは一時ファイルまたはロックファイルをこのディレクトリに書き込みます。

For EAR/WAR installations typically, this directory is /tmp on Linux systems, or C:\Temp on Windows.

For Standalone installations the temp directory is located in the installation directory as /temp.

このディレクトリのロケーションを変更するには、次の引数を指定して、Confluence を実行している Java 仮想マシンを開始します。

-Djava.io.tmpdir=/path/to/your/own/temp/directory.

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.