プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Coherenceのインストール
12c (12.2.1.2.0)
E82726-01
目次へ移動
目次

前へ
次

2 Oracle Coherence for Javaのインストール

この章では、Oracle Coherence for Java(略してCoherence)のインストールおよび実行手順について説明します。Coherence*Extendクライアント・ディストリビューションをインストールする手順は、クライアント・ディストリビューションのインストールを参照してください。Coherence*Webをアプリケーション・サーバーにインストールする手順は、アプリケーション・サーバーへのCoherence*Webのインストールを参照してください。

この章の内容は次のとおりです。

2.1 システム要件

Coherenceの要件は、インストールおよびランタイムで異なります。

ランタイム要件

開発環境でCoherenceを実行するために推奨される最小限のシステム要件を次に示します。

  • 100 MBのディスク領域(APIのドキュメントおよびサンプルを含む完全なインストールの場合)

  • 1GBのRAM (Javaの最大ヒープ・サイズを512MBとした場合) - この容量のRAMでは、すべてのデータのバックアップを格納するように構成された単一ノード上での理想的な150MBの最大キャッシュ・サイズ(150MB x 2)がサポートされ、1/3以上のヒープをスクラッチおよびJVMタスクに使用できます。この推奨事項は基本的な開始点として考慮し、ルールとして考慮しないようにしてください。キャッシュ・サイズの計算の詳細は、『Oracle Coherenceの管理』を参照してください。

  • JVM (JREまたはJDK) 1.8以上。多くの場合、開発にはJDKが使用されます。JDKはJavaアプリケーションのモニタリングおよびトラブルシューティングのためのツールを提供しますが、Coherenceの実行には必須ではありません。

    注意:

    古いバージョンのJVMを実行するアプリケーションと統合して使用する顧客は、古いCoherenceクライアントを使用できます。ただし、クライアントは、そのCoherenceのバージョンでサポートされているプラットフォームおよびクライアントの機能に限定されます。

  • 必要なJavaのバージョンをサポートするWindowsベースまたはUNIXベースのシステム

  • ネットワーク・アダプタ

インストール要件

Coherenceインストーラを使用するための最小要件は次のとおりです。

注意:

インストーラを実行する要件は、Coherenceを実行する要件とは異なります。

  • 300 MHz CPU

  • 512 MBスワップ領域

  • 256カラー・モニター(GUIベースのインストールにのみ必要)

  • JDK 1.6.0_4以上

2.2 Coherenceのインストールの実行

Coherenceは、Oracle Universal Installerを使用してインストールします。このインストーラは、Oracle製品のインストールとパッチ・サービスの両方を提供します。Coherenceに使用可能なインストーラは次のとおりで、この項で詳細を説明します。

Coherenceは、常にORACLE_HOME/coherenceディレクトリにインストールされます。Coherenceのドキュメントでは、coherenceディレクトリへの完全なパスをCOHERENCE_HOMEと呼びます。

2.2.1 グラフィカル・モードでのCoherenceのインストールの実行

Coherenceインストーラは、fmw_version_coherence.jarという実行可能なJava ARchive (JAR)ファイルとして配布されます。ターゲット・コンピュータでインストーラを実行するには、javaコマンドを使用します。インストーラのオプションに関する詳細なヘルプについては、インストーラの実行中に-help引数を使用してください。

インストーラで作成されるディレクトリの詳細は、Oracle Coherenceディレクトリ構造の理解を参照してください。

この項には次のトピックが含まれます:

2.2.1.1 インストール・プログラムの起動

グラフィカル・モードでのCoherenceのインストールの実行手順は、次のとおりです。

  1. fmw_version_coherence.jarファイルをターゲット・コンピュータにコピーします。
  2. コマンド・プロンプトから、ディレクトリをcoherence_version.jarファイルの場所に変更し、次のコマンドを実行します(JAVA_HOME/binがコンピュータのPATHにあると想定します)。
    java -jar fmw_version_coherence.jar
    

インストール・プログラムが表示されると、インストールを開始する準備ができています。

各インストール・プログラム画面の説明については、インストール画面への移動を参照してください。

2.2.1.2 インストール画面のナビゲート

表2-1では、インストール・プログラムが表示される順序に画面が列挙されています。

インストール画面に関して詳細な情報が必要な場合は、画面名をクリックしてください。

表2-1 Oracle Coherenceのインストール画面

画面 説明

インベントリ設定

この画面は、UNIXオペレーティング・システムで、このホストに初めてOracle製品をインストールする場合に表示されます。中央インベントリを作成する場所を指定します。この画面で選択したオペレーティング・システム・グループ名には、中央インベントリの場所への書込み権限があることを確認してください。

中央インベントリの詳細は、Oracle Fusion Middleware Oracle Universal Installerによるソフトウェアのインストールの「Oracle中央インベントリの理解」を参照してください。

この画面はWindowsオペレーティング・システムでは表示されません。

ようこそ

製品のインストーラの紹介画面です。

インストール場所

ドロップダウン・リストを使用して、Coherenceのインストール先の既存のORACLE_HOMEディレクトリを選択するか、絶対パスを入力して新しいCoherence ORACLE_HOMEディレクトリを作成します。必要に応じて「参照」をクリックしてディレクトリを検索します。ディレクトリは、既存のCoherenceのインストールを含むことはできません。

インストール・タイプ

インストールするCoherenceのオプションを選択します。

前提条件チェック

この画面には、Coherenceがシステムで認証されていることを確認するために実行するシステム・チェックのリストが表示されます。

インストール・サマリー

インストールを確認します。今回のインストールを別のコンピュータに複製する予定がある場合は、「レスポンス・ファイルの保存」をクリックします。まったく同じインストール設定でサイレント・インストールを実行する際に使用可能なレスポンス・ファイルが作成されます。サイレント・インストールの実行の詳細は、サイレント・モードでのCoherenceのインストールの実行を参照してください。

インストールの進行状況

この画面では、インストールの進行状況を参照できます。

インストール完了

インストールが完了すると、この画面が表示されます。この画面の情報を確認してから、「終了」をクリックしてインストーラを終了します。

2.2.2 サイレント・モードでのCoherenceのインストールの実行

サイレント・モードでは、グラフィカル・インタフェースを使用せずにCoherenceをインストールでき、リモート・インストールの場合またはスクリプトの一部としてインストールを組み込む場合に便利です。サイレント・モードでは、一般的に、name=valueのペアとしてインストール・パラメータを含むレスポンス・ファイル(.rsp)を使用します。グラフィカル・モードでインストーラを実行し、「インストール・サマリー」画面でインストール・パラメータをレスポンス・ファイルに保存することでレスポンス・ファイルを作成します。保存したファイルを使用して他のコンピュータでインストールをレプリケートするか、必要に応じてファイルを編集してインストールを変更します。

サイレント・モードでのCoherenceのインストールの実行手順は、次のとおりです。

  1. fmw_version_coherence.jarファイルおよびレスポンス・ファイルをターゲット・コンピュータにコピーします。
  2. コマンド・プロンプトから、ディレクトリをcoherence_version.jarファイルの場所に変更し、次のコマンドを実行します(JAVA_HOME/binがコンピュータのPATHにあると想定します)。
    java -jar fmw_version_coherence.jar -silent -responseFile full_path_to_response_file -waitForCompletion
    

    UNIXベースのプラットフォームの場合は、oraInst.locインベントリ・ディレクトリ・ポインタ・ファイルがデフォルトの場所(/etc)に見つからないと、そのファイルの場所を要求されます。このコンピュータにOracle製品をインストールしたのが初めてである場合は、createCentralInventory.shスクリプトを使用して、/etcディレクトリのインベントリ・ディレクトリ・ポインタ・ファイルを設定できます。このスクリプトには、ルート権限が必要です。

    oraInst.locファイルにカスタムの場所を使用する場合は、-invPtrLocインストーラ・オプションを使用して場所を指定します。次に例を示します。

    java -jar fmw_version_coherence.jar -silent -responseFile full_path_to_response_file -waitForCompletion -invPtrLoc /MyDirectory/oraInst.loc
    

    oraInst.locファイルの内容には、インベントリ・ディレクトリの場所および所有者グループが含まれます。次に例を示します。

    inventory_loc=/MyDirectory/oraInventory
    inst_group=group

2.2.3 Coherenceクイック・インストーラの実行

クイック・インストールは、fmw_version_coherence_quick.jarという実行可能なJARファイルとして配布されます。ターゲット・コンピュータでインストーラを実行するには、javaコマンドを使用します。インストーラのオプションに関する詳細なヘルプについては、インストーラの実行中に-help引数を使用してください。

クイック・インストールは、オプションのないサイレント・インストールを実行します。この配布に含まれるライフサイクル・ツールは多くありませんが、Oracleインベントリの一部として、将来ライフサイクル操作を使用できるCoherenceコンポーネントを登録します。また、このインストールには、APIのドキュメントおよびコード・サンプルは含まれません。結果として、通常のCoherenceインストーラよりもインストール・プロセスが高速になり、インストール・フットプリントが小さくなります。ユーザーの操作を必要とせずにスクリプトの一部としてCoherenceをインストールする理想的な方法です。

Coherenceのクイック・インストールの実行手順は、次のとおりです。

  1. fmw_version_coherence_quick.jarファイルをターゲット・コンピュータのディレクトリにコピーします。
  2. コマンド・プロンプトから、ディレクトリをfmw_version_coherence_quick.jarファイルの場所に変更し、次のコマンドを実行します(JAVA_HOME/binがコンピュータのPATHにあると想定します)。
    java -jar fmw_version_coherence_quick.jar ORACLE_HOME=/oracle
    

    ORACLE_HOME変数の値は、CoherenceがインストールされるORACLE_HOMEディレクトリを指定します。この値は絶対パスである必要があります。ディレクトリがすでに存在する場合は、空であるか、または既存の有効なORACLE_HOMEである必要があります。ディレクトリは、既存のCoherenceのインストールを含むことはできません。ディレクトリが存在しない場合は、インストーラによって作成されます。また、空である現在の作業ディレクトリからインストールを開始し、ORACLE_HOME変数を省略することも可能で、この場合は現在の作業ディレクトリがORACLE_HOMEディレクトリになります。次に例を示します。

    cd /oracle
    java -jar /tmp/fmw_version_coherence_quick.jar
    

    UNIXベースのプラットフォームの場合、クイック・インストーラは/etcディレクトリ内のoraInst.locインベントリ・ディレクトリ・ポインタ・ファイルを見つけようとします。ファイルが見つからない場合は、/tmpディレクトリがインベントリ・ディレクトリとして使用されます。このコンピュータにOracle製品をインストールしたのが初めてである場合は、createCentralInventory.shスクリプトを使用して、/etcディレクトリのインベントリ・ディレクトリ・ポインタ・ファイルを設定できます。このスクリプトには、ルート権限が必要です。

    oraInst.locファイルにカスタムの場所を使用する場合は、-invPtrLocインストーラ・オプションを使用して場所を指定します。次に例を示します。

    java -jar fmw_version_coherence_quick.jar -invPtrLoc /MyDirectory/oraInst.loc
    

    oraInst.locファイルの内容には、インベントリ・ディレクトリの場所および所有者グループが含まれます。次に例を示します。

    inventory_loc=/MyDirectory/oraInventory
    inst_group=group

2.2.4 Coherenceサプリメンタル・インストーラの実行

サプリメンタル・インストールは、fmw_version_coherence_quick_supplemental.jarという実行可能なJARファイルとして配布されます。この配布は、既存のCoherenceインストールにAPIのドキュメントおよびコード・サンプルをインストールするために使用します。サプリメンタル・インストーラは、オプションなしのサイレント・インストールを実行します。通常は、ユーザーの操作なしでスクリプトの一部としてインストールを実行するクイック・インストーラとあわせて使用します。APIのドキュメントおよびコード・サンプルが不要な場合は、サプリメンタル・インストールをスキップできます。

  1. fmw_version_coherence_quick_supplemental.jarファイルをCoherenceのインストール先のORACLE_HOMEディレクトリにコピーします。
  2. コマンド・プロンプトから、ディレクトリをfmw_version_coherence_quick_supplemental.jarファイルの場所に変更し、次のコマンドを実行します(JAVA_HOME/binがコンピュータのPATHにあると想定します)。
    java -jar fmw_version_coherence_quick_supplemental.jar
    

    インストールが開始され、ステータス・メッセージが出力されます。

2.2.5 WebLogic ServerとCoherenceのインストール

WebLogic ServerインストーラにはCoherenceの配布が含まれており、WebLogic Serverと同じORACLE_HOMEディレクトリにCoherenceがインストールされます。WebLogic Serverには、WebLogic Serverドメイン内でのCoherenceの管理方法およびデプロイ方法を標準化するCoherence統合が用意されています。この統合により、CoherenceをWebLogic Serverのサブシステムにして、Coherence環境の管理にWebLogic Serverのツールおよびインフラストラクチャ(Java EEスタイルのパッケージ化およびデプロイ、リモート・サーバー管理、サーバー・クラスタ、WebLogic Scripting Tool (WLST)の自動化、管理コンソールによる構成など)を使用できます。WebLogic ServerとCoherenceのインストールの詳細は、『Oracle WebLogic ServerおよびCoherenceのインストールと構成』を参照してください。

2.3 環境変数の設定

次のシステム環境変数を設定することもできますが、Coherenceを実行するために必ず設定しなければならないわけではありません。

  • JAVA_HOME - この変数はCOHERENCE_HOME/binディレクトリに含まれるスクリプトを実行するときに使用されます。この変数の値はJavaインストール・ディレクトリへのフル・パスです。JAVA_HOMEが設定されていない場合は、コンピュータのデフォルトのJavaインストール・ディレクトリが使用されます。この変数を設定すると、スクリプトで特定のJavaバージョンが使用されるようにすることができます。

  • COHERENCE_HOME - この変数は、通常は便宜上設定されるものです。この変数の値はORACLE_HOME/coherenceディレクトリへのフル・パスです。

2.4 Coherenceの最初の実行

COHERENCE_HOME/binディレクトリには、開発およびテストの際に使用される、設計用に提供されたスクリプトが含まれています。cache-serverスクリプトはデフォルト構成を使用してキャッシュ・サーバーを起動します。coherenceスクリプトは、デフォルト構成を使用してキャッシュ・ファクトリ・インスタンスを起動します。キャッシュ・ファクトリ・インスタンスには、特にキャッシュの作成と操作に使用されるコマンド行ツールが含まれています。

この例では、基本的なクラスタを作成した後、クラスタにホストされるキャッシュをコマンド行ツールを使用して作成および操作します。

2.4.1 基本的なクラスタの作成

この手順では、キャッシュ・サーバーと2つのキャッシュ・ファクトリ・インスタンスという3つの独立したJavaプロセスで構成される基本的なクラスタを作成します。簡素化を図るため、この2つのプロセスは単一のマシン上に置かれます。この3つのプロセスは1つのコンピュータ上に共存します。キャッシュ・サーバーは、デフォルトで、バックアップ・データを格納するように構成されます。2つのキャッシュ・ファクトリ・インスタンスは、デフォルトで、バックアップ・データを格納しないように構成されます。各プロセスが起動されるたびに、それら3つのプロセスが自動的に結合され、クラスタ・メンバー(クラスタ・ノードとも呼ばれる)となります。

この例では、これらのクラスタ・メンバーがネットワーク上で実行されている可能性のある既存のCoherenceクラスタに参加しないようにするために、Coherenceの初期状態のデフォルト構成を多少修正してプライベートなクラスタを作成します。

注意:

Coherenceは、デフォルトではマルチキャストを使用してクラスタ・メンバーを検出します。ネットワークでマルチキャストを使用できない場合は、ユニキャストを使用するようにCoherenceを構成できます。詳細は、『Oracle Coherenceでのアプリケーションの開発』を参照してください。

基本的なクラスタを作成するには:

  1. テキスト・エディタを使用してCOHERENCE_HOME/bin/cache-serverスクリプトを開きます。
  2. java_opts変数を修正します。次のように、システム・プロパティcoherence.clusterを含めてください。
    set java_opts="-Xms%memory% -Xmx%memory% -Dcoherence.cluster=cluster_name"
    

    cluster_nameを、クラスタ内で一意の値に置き換えます。たとえば、クラスタ名に自分の名前を使用します。

  3. cache-serverスクリプトを保存して閉じます。
  4. 手順1から手順3をCOHERENCE_HOME/bin/coherenceスクリプトで繰り返し、同じ値をcluster_nameに指定します。
  5. cache-serverスクリプトを実行します。キャッシュ・サーバーが起動し、このクラスタ・メンバーに関する情報が出力されます。
  6. coherenceスクリプトの2つのインスタンスを実行します。インスタンスが起動するたびに、それぞれのクラスタ・メンバーに関する情報が出力されます。インスタンスはそれぞれ、コマンド行ツールのコマンド・プロンプトを返します。

2.4.2 キャッシュの作成

この手順では、キャッシュが作成され、基本クラスタ上でホストされます。最初のキャッシュ・ファクトリ・インスタンスのコマンド行ツールを使用して、単純な文字列がキャッシュに入力されます。次に、2番目のキャッシュ・ファクトリ・インスタンスのコマンド行ツールを使用して、キャッシュから文字列が読み出されます。サンプルは非常に単純であり、あまり実用的ではありませんが、Coherenceキャッシュの出荷時の特性を端的に示しています。さらに、これらの手順は、通常はCoherence APIを使用して直接実行されます。

キャッシュを作成するには:

  1. いずれかのキャッシュ・ファクトリ・インスタンスのコマンド・プロンプトで、cacheコマンドを使用してTestという名前のキャッシュを作成します。
    cache Test
    
  2. コマンド・プロンプトでputコマンドを使用してキーと値の組合せを入力することにより(空白で区切る)、単純な文字列を新しいキャッシュに配置します。
    put key1 Hello
    

    コマンドによってnullが返され、表示されます。putコマンドは、所定のキーに対して常に前の値を返します。null値が返されたのは、これがそのキーに最初に入力された値だったためです。

  3. もう1つのキャッシュ・ファクトリ・インスタンスに切り替えて、コマンド・プロンプトでcacheコマンドを使用してTestという名前のキャッシュを作成します。
    cache Test
    
  4. このコマンド・プロンプトで、getコマンドを使用してキャッシュ内の文字列を読み出して、次のキー名を入力します。
    get key1
    

    コマンドによってhelloが返され、表示されます。キャッシュ・ファクトリ・プロセスが両方とも同一クラスタに属しており、Testキャッシュがすべてのクラスタ・メンバーに認識されているため、どちらのプロセスを使用してもキャッシュ・エントリの追加または削除が可能です。また、キャッシュ・サーバーにキャッシュ・データのバックアップが格納されているため、いずれの(または両方の)キャッシュ・ファクトリ・プロセスがシャットダウンされてもキャッシュ・データは保持されます。

2.5 Mavenとの統合

Mavenは、プロジェクトの依存性、サード・パーティの依存性およびビルドのライフサイクル定義の構成を可能にするビルドおよび依存性システムです。ソフトウェアのプロジェクトでは、ビルド・プロセスを容易化および標準化するためにMavenがよく使用されます。Mavenの詳細は、http://maven.apache.org/を参照してください。

Oracle Middlewareには、Oracleホーム・ディレクトリをMavenリポジトリと同期化し、Mavenの使用と命名規則を標準化するプラグインが用意されています。このプラグインを使用すると、CoherenceアーティファクトをMavenリポジトリにアップロードできるようになり、それによってアーティファクトが開発プロジェクトでどのように消費されているかが容易化されます。Mavenの設定および同期化プラグインの使用の詳細は、『Continuous Integrationを使用したアプリケーションの開発』を参照してください。

また、Mavenの統合には、Coherenceグリッド・アーカイブ(GAR)用のアーキタイプおよびパッケージ化プラグインが含まれます。Coherence GARは、CoherenceアプリケーションをWLSドメイン内にデプロイする際に通常使用されるモジュール・タイプです。Mavenアーキタイプ・プラグインはGAR構造を生成し、サンプルの構成ファイルを提供します。パッケージ化プラグインは、プロジェクトの内容および依存性に基づいてGARを生成し、依存性、ソースおよび構成ファイルが正しくGARにコピーされるようにします。

Coherence用のMavenプラグインおよび構成ファイルは、COHERENCE_HOME/pluginsディレクトリにあります。Maven GARプラグインおよびアーキタイプは、同期化プラグインの一部としてエンタープライズ・リポジトリにインストールされます。プラグインを使用してCoherenceをビルド・プロセスに組み込む手順については、『Continuous Integrationを使用したアプリケーションの開発』を参照してください。

2.6 Coherenceパッチのインストール

Coherenceのパッチは、My Oracle Supportで定期的に更新されます。

https://support.oracle.com

パッチは、Oracleの標準パッチ適用メカニズムを使用してインストールされます。パッチのインストールの詳細は、『Oracle® Fusion Middleware Opatchによるパッチ適用』を参照してください。

2.7 Coherenceのアンインストール

Coherenceをアンインストールするには、Oracle Fusion Middleware Deinstallerを使用します。アンインストーラでは、アンインストールするCoherenceのORACLE_HOMEディレクトリのコンポーネントを選択することができ、CoherenceのORACLE_HOMEディレクトリを完全に削除する場合にも使用できます。

アンインストール・ウィザードを使用してCoherenceをアンインストールするには、アンインストーラを起動します。UNIXベース・プラットフォームでは、Coherence ORACLE_HOME/oui/bin/deinstall.shスクリプトを使用し、Windowsでは、Coherence ORACLE_HOME\oui\bin\deinstall.cmdスクリプトを使用します。Windowsの場合は、スクリプトへのショートカットが使用可能で、これはスタート・メニューのOracleプログラム・グループの中にあります。

表2-2では、アンインストール・プログラムが表示される順序に画面が列挙されています。

表2-2 Oracle Coherenceのアンインストール画面

画面 説明

ようこそ

製品のアンインストーラの紹介画面です。

アンインストール・サマリー

画面が表示され、アンインストールされる機能の一覧が表示されます。

アンインストールの進行状況

画面が表示され、成功および失敗したタスクがすべて表示されます。

アンインストール完了

画面が表示され、アンインストールのサマリーが表示されます。「終了」をクリックし、アンインストール・プログラムを閉じます。

注意:

ORACLE_HOMEディレクトリ内の追加ファイルは手動で削除する必要があります。Windowsの場合は、スタート・メニューにあるOracleプログラム・グループも手動で削除する必要があります。