Versions Compared

キー

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

要約

Oracle Coherence (formerly known as Tangosol Coherence) is the technology that provides clustering and distributed caching in Confluence. It has also been used for caching purposes in non-clustered Confluence deployments.

Oracle Coherence テクノロジーは Confluence バージョン 2.3 で最初に組み込まれました。それ以降、アトラシアンは次の手段を使用して Coherence テクノロジー ライブラリ ファイルを配布してきました。

  • バージョン 2.3 の Web サイトからダウンロード可能な Confluence のすべてのバージョンとディストリビューションに含まれます (クラスタ版または単一サーバー インストール版を問わない)。
  • Atlassian Maven リポジトリから。

しかしながら、アトラシアンでは Coherence テクノロジーに関連して、Oracle と新しいライセンス契約を締結しようとしています。これにより、2009 年 9 月下旬から、アトラシアンは、ライセンス (Confluence クラスタ ライセンス) を購入したお客様にのみ Coherence ライブラリ ファイルを配布できるようになります。

その結果、次の変更が発生します。

  • Confluence (3.0.1) の次のバージョンは 2 つのバージョンでリリースされます。
    • Standard — Editions of Confluence without the Coherence library files. Ehcache will replace the local caching functionality previously provided by the Coherence technology.
    • クラスタ — Coherence ライブラリ ファイルを含む Confluence エディション。
  • 非クラスタ用の Confluence ライセンスを購入したお客様は、アトラシアンの Web サイトから Confluence の標準エディションのみをダウンロードできます。Confluence のクラスタ用ライセンスを購入したお客様は Confluence のクラスタ エディションをダウンロードできます。
  • 2009 年 9 月後半以降:
    • Confluence の標準エディションは、Confluence バージョン 2.6 までのそれぞれのメジャー リリースに対して提供されます。これらは、Confluence バージョン 2.10.4、2.9.3、2.8.3、2.7.4および 2.6.3 として提供され、非クラスタ用ライセンスをお持ちのお客様が利用できます。
    • All other previous versions of Confluence currently available from our download page (from 2.6 to 3.0 inclusively), will be re-released as clustered editions and will only be available to customers with Confluence clustered licenses.
    • Coherence ライブラリ ファイルは、Atlassian Maven リポジトリから形式を問わず利用できなくなります。
    • 2.6 以前の (サポート終了済みの) すべての Confluence バージョンのインストール ファイルはアトラシアンの Web サイトから削除され、ダウンロードおよびインストールできなくなります。
注意

現在 Confluence のクラスタ インストールを実行している場合、Confluence の標準エディションでのアップグレードを行わないでください。

どのような影響がありますか?

Confluence 2.3 以降を実行中で、非クラスタ Confluence ライセンスを持つ Confluence のお客様の場合

実行中の Confluence ディストリビューションは引き続き機能します。Confluence バージョン 2.6 以降の場合、当社の標準サポート ポリシーにしたがい、アトラシアンのサポート対象になります。

ただし、Confluence バージョン 3.0.1 以降にアップグレードする場合、または 2009 年 9 月下旬以降にリリースされた Confluence バージョンを利用する場合、Confluence の標準エディションのみをダウンロードしてアップグレードできます。

I run a customised installation of Confluence 2.3 or later and must build Confluence from source.

2009 年 9 月下旬より前にダウンロードされた Confluence ソース コードでは、自動 Maven ビルドを正常に完了させるために、Coherence ライブラリ ファイルがローカル リポジトリまたは Atlassian Maven リポジトリに存在している必要があります。

2009 年 9 月下旬より前に Confluence ソース コードをダウンロードし (バージョン 3.0.1 を除く)、この日付以降にこのソース コードを使用して Confluence の自動 Maven ビルドを実施している場合、ローカル Maven リポジトリで Coherence ライブラリ ファイルを使用できないと、ビルドが失敗します。これは、Atlassian Maven リポジトリで Coherence ライブラリ ファイルが提供されなくなるためです。

Hence, to build a customised installation of Confluence using this source code, we recommend that you locate the tangosol-3.3.jar and coherence-3.3.jar from the WEB-INF/lib directory of your own existing Confluence installation and install them into your local Maven repository using the following commands:

コー​​ドブロック
mvn install:install-file -Dfile=tangosol-3.3.jar -DgroupId=tangosol-coherence \
-DartifactId=tangosol -Dversion=3.3 -Dpackaging=jar
mvn install:install-file -Dfile=tangosol-3.3.jar -DgroupId=tangosol-coherence \
-DartifactId=coherence -Dversion=3.3 -Dpackaging=jar
注意

These commands will install the Coherence library files into your local Maven repository, which should be available to you only. Please do not upload these files to any public Maven repository nor make them publicly available by any other means. Atlassian's End User License Agreement does not grant permission to redistribute any part of Confluence, which includes these Coherence library files.

Alternatively, you can download the sources for one of the new standard or clustered editions of Confluence and reapply your customisations. These will compile without any additional problems.

プラグイン開発者が Confluence の古いバージョンまたは既存のバージョンに対してプラグインをコンパイルしたい場合

これは、2 つの方法でプラグイン開発者に影響します。

  1. プラグインの構築時、アトラシアンの Maven リポジトリに Coherence ライブラリ ファイルがない旨のメッセージが Maven によって表示されます。
  2. Atlassian Plugin Toolkit を使用してプラグインをテストする場合、Maven は統合テストを実行するための適切な Confluence EAR-WAR ディストリビューション ファイルを (Atlassian Maven リポジトリから) ダウンロードできなくなります。

したがって、プラグイン開発者は可能な限り早く、Confluence の新しい標準バージョン (Confluence ライブラリ ファイルを含まないもの) に基づいてプラグインのコンパイルを開始することをお勧めします。Confluence の標準エディションには、クラスタ エディションと既存の Confluence のクラスタ インスタンスとのバイナリ互換性があります。したがって、Confluence の標準エディションに対して開発されたプラグインは、クラスタ エディションおよび Confluence の既存のクラスタ インスタンスでも実行されます。

これらの変更による API の変更や複数の Confluence エディションについて懸念しているプラグイン開発者の場合

Confluence API のみを使用してプラグインを開発している場合、そのプラグインは Confluence の標準エディションとクラスタ エディションの両方とのバイナリ互換性を持ちます。Confluence CacheManagerCache および ClusterManager のインターフェイスは両方のエディションの Confluence で同じですが、以前のバージョンの Confluence からの重要な変更が 1 つだけあります。

Confluence の既存のバージョンでは、ClusterManager によって Coherence InvocationService が表示され、クライアントはクラスタのすべてのノードでコードを実行したり、クエリを実行したりできます。この API は、Confluence のすべての標準バージョン (バージョン 3.0.1 から 2. 6 まで) で使用できなくなります。プラグインがこのサービスを使用している (およびアトラシアンがそれを認識していない) 場合、Confluence の RemoteEvent API を使用して他のクラスタ ノードにメッセージを送信し、作業を実行するように指示する必要があります。

また、何らかの理由でプラグインが他の Coherence クラスを直接参照している (CacheManagerCache または ClusterManager の Coherence 固有の実装をインポートする) 場合は、プラグインを書き直して汎用インターフェイスのみを使用する必要があります。

プラグイン開発者がクラスタの Confluence に対してプラグインをテストしたい場合

テストのため、Confluence クラスタ ライセンスを所有し、クラスタ化された Confluence インストール (既存のライセンスまたは Confluence クラスタ エディションに基づくライセンス) にアクセスできる必要があります。