スタートガイド

手順2.2 JBoss Data Grid のダウンロード

1. カスタマーポータル (https://access.redhat.com) にログインします。
2. ページ最上部にある ダウンロード ボタンをクリックします。
3. 製品のダウンロード ページで Red Hat JBoss Data Grid をクリックします。
4. Version: ドロップダウンメニューから適切な JBoss Data Grid バージョンを選択します。
5. 表示されるリストから適切なファイルをダウンロードします。

手順2.3 ダウンロードされたファイルの検証

1. Red Hat カスタマーポータルからダウンロードしたファイルにエラーがないことをポータルサイト上で検証するには、パッケージの Software Details ページに移動します。このページには、MD5 および SHA256 のチェックサム値が記載されています。チェックサム値を使用してファイルの整合性をチェックします。
2. ターミナルウインドウを開き、ダウンロードしたファイルを引数として指定して md5sum または sha256sum コマンドを実行します。コマンドの出力として、ファイルのチェックサム値が表示されます。
3. コマンドによって返されたチェックサム値と、そのファイルの Software Details ページに記載されている値を比較します。

   注記

   Microsoft Windows にはチェックサムツールが同梱されていません。Windows オペレーティングシステムのユーザーはサードパーティーの製品をダウンロードする必要があります。

手順2.4 JBoss Data Grid のインストール

1. ダウンロードした JBoss Data Grid パッケージをマシン上の希望の場所にコピーします。
2. 次のコマンドを実行して、ダウンロードした JBoss Data Grid パッケージを展開します。

   $ unzip JDG_PACKAGE

   Copy to Clipboard Toggle word wrap
   JDG_PACKAGE は、Red Hat カスタマーポータルからダウンロードした JBoss Data Grid 使用モードパッケージの名前に置き換えます。
3. 展開したディレクトリーは $JDG_HOME とします。

手順3.1 ローカルファイルシステムリポジトリーのインストール (JBoss Data Grid)

1. カスタマーポータルへのログイン

   ブラウザーでカスタマーポータルページ (https://access.redhat.com/home) に移動し、ログインします。

2. JBoss Data Grid リポジトリーファイルのダウンロード

   Red Hat カスタマーポータルから jboss-datagrid-{VERSION}-maven-repository.zip をダウンロードします。
3. ローカルファイルシステムのディレクトリー (例: $JDG_HOME/projects/maven-repositories/) にファイルを展開します。

1. Web ブラウザーを開き、https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?product=data.grid にアクセスします。
2. リストから Red Hat JBoss Data Grid 7.0.0 Maven Repository を見つけます。
3. ダウンロード ボタンをクリックし、リポジトリーが含まれる .zip ファイルをダウンロードします。
4. Apache サーバー上で Web にアクセス可能なディレクトリーにファイルを展開します。
5. Apache を設定し、作成されたディレクトリーの読み取りアクセスとディレクトリの閲覧を許可します。

手順3.2 オフラインでの使用に向けた JBoss Data Grid Maven リポジトリーの設定

1. 「ローカルファイルシステムリポジトリーのインストール」 の手順に従って、ダウンロードされた JBoss Data Grid Maven リポジトリーをローカルにインストールします。
2. 「Maven レポジトリーの設定」にあるように settings.xml がローカルに抽出されたリポジトリーを指すように更新します。サンプル設定は以下のようになります。

   <?xml version="1.0" encoding="UTF-8"?>
   
   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
   
      <profiles>
         <profile>
            <id>jboss-datagrid-repository</id>
            <repositories>
               <repository>
                  <id>jboss-datagrid-repository</id>
                  <name>JBoss Data Grid Maven Repository</name>
                  <url>file:///path/to/jboss-datagrid-7.0.0.GA-maven-repository/maven-repository</url>
                  <layout>default</layout>
                  <releases>
                     <enabled>true</enabled>
                     <updatePolicy>never</updatePolicy>
                  </releases>
                  <snapshots>
                     <enabled>false</enabled>
                     <updatePolicy>never</updatePolicy>
                  </snapshots>
               </repository>
            <pluginRepositories>
               <pluginRepository>
                  <id>jboss-datagrid-repository</id>
                  <name>JBoss Data Grid Maven Repository</name>
                  <url>file:///path/to/jboss-datagrid-7.0.0.GA-maven-repository/maven-repository</url>
                  <layout>default</layout>
                  <releases>
                     <enabled>true</enabled>
                     <updatePolicy>never</updatePolicy>
                  </releases>
                  <snapshots>
                     <enabled>false</enabled>
                     <updatePolicy>never</updatePolicy>
                  </snapshots>
               </pluginRepository>
            </pluginRepositories>
         </profile>
      </profiles>
      <activeProfiles>
         <!-- make the profile active by default -->
         <activeProfile>jboss-datagrid-repository</activeProfile>
      </activeProfiles>
   
   </settings>

   Copy to Clipboard Toggle word wrap
3. プロジェクトがローカルにビルドできることを確認します。

手順4.3 Karaf への Hot Rod クライアント機能のインストール

1. Karaf 2.3.3

   Karaf 2.3.3 では次のコマンドを使用します。

   1. karaf@root> features:addUrl mvn:org.infinispan/infinispan-remote/${VERSION}/xml/features

      Copy to Clipboard Toggle word wrap

   2. karaf@root> features:install infinispan-remote

      Copy to Clipboard Toggle word wrap
   3. 機能が正しくインストールされたことを確認します。

      karaf@root> features:list
       //output

      Copy to Clipboard Toggle word wrap

2. Karaf 3.0.0

   次のコマンドを使用します。

   1. karaf@root> feature:repo-add mvn:org.infinispan/infinispan-remote/${VERSION}/xml/features

      Copy to Clipboard Toggle word wrap

   2. karaf@root> feature:install infinispan-remote

      Copy to Clipboard Toggle word wrap
   3. 機能が正しくインストールされたことを確認します。

      karaf@root> feature:list

      Copy to Clipboard Toggle word wrap
   この代わりに、-i コマンドパラメーターを以下のように使用して、Hot Rod クライアント機能をインストールすることもできます。

   karaf@root()> feature:repo-add -i mvn:org.infinispan/infinispan-remote/${VERSION}/xml/features

   Copy to Clipboard Toggle word wrap

手順4.4 features ファイルを使用したバンドルのインストール

1. Karaf コンソールの起動

   以下のコマンドを使用して Karaf コンソールを起動します。

   $ cd $APACHE_KARAF_HOME/bin
   $ ./karaf

   Copy to Clipboard Toggle word wrap

2. feature リポジトリーの登録

   次のように feature リポジトリーを登録します。
   • Karaf 2.3.3 の場合

     karaf@root()> features:addUrl mvn:org.infinispan/infinispan-embedded/${VERSION}/xml/features

     Copy to Clipboard Toggle word wrap

     karaf@root> features:install infinispan-embedded

     Copy to Clipboard Toggle word wrap
   • Karaf 3.0.0 の場合

     karaf@root()> feature:repo-add mvn:org.infinispan/infinispan-embedded/${VERSION}/xml/features

     Copy to Clipboard Toggle word wrap

     karaf@root> feature:install infinispan-embedded

     Copy to Clipboard Toggle word wrap

手順5.1 JBoss Data Grid のインストール

• JBoss Data Grid のインストールに関する情報は、パートII「Red Hat JBoss Data Grid のダウンロードおよびインストール」を参照してください。JBoss Fuse で Camel コンポーネントを実行するには、以下の JBoss Data Grid コンポーネントのみが必要になります。
  • JBoss Data Grid Maven リポジトリー。
  • The JBoss Data Grid Server パッケージ (Hot Rod クライアントを使用するため)。

手順5.2 JBoss Fuse のインストール

1. JBoss Fuse フルインストールのダウンロード

   Red Hat JBoss Fuse アーカイブは、Red Hat カスタマーポータルでアカウントを登録してログインした後に、ダウンロード>Red Hat JBoss Fuse と選択すると表示される Software Downloads のページからダウンロードできます。
   ログインしている状態で以下を行います。
   1. Software Downloads ページの Product ドロップダウンメニューで Fuse を選択します。
   2. Software Downloads ページの Version ドロップダウンリストで 6.1.0 を選択します。
   3. Red Hat JBoss Fuse 6.1.0 ディストリビューションファイルの横にある Download ボタンをクリックし、ダウンロードします。
   JBoss Fuse では、異なる機能セットが含まれるインストールを選択できます。JBoss Data Grid を JBoss Fuse と実行するには、フルインストールが必要になります。フルインストールには以下が含まれます。
   • Apache Karaf
   • Apache Camel
   • Apache ActiveAMQ
   • Apache CXF
   • Fuse 管理
   • コンソール (hawtio)
   • JBI コンポーネント

2. アーカイブの展開

   Red Hat JBoss Fuse は、アーカイブをシステムで展開するとインストールされます。JBoss Fuse は zip ファイルとしてパッケージ化されています。適切なアーカイブツールを使用して、Red Hat JBoss Fuse を完全なアクセス権限を持つディレクトリーで展開します。

   警告

   パス名に空白文字が含まれるフォルダーにアーカイブファイルを展開しないでください。たとえば、C:\Documents and Settings\Greco Roman\Desktop\fusesrc. で展開しないでください。

   さらに、パス名に特殊文字 #、%、^、または " が含まれるフォルダーにアーカイブファイルを展開しないでください。

3. リモートコンソールユーザーの追加

   サーバーのリモートコマンドコンソールはデフォルトユーザーには設定されていません。サーバーのコンソールへリモート接続する前に、ユーザーを設定に追加します。

   重要

   このファイルの情報は暗号化されていないため、厳重なセキュリティーを必要とする環境には適していません。
   ユーザーを追加するには、以下を実行します。
   1. テキストエディターで InstallDir/etc/users.properties を開きます。
   2. 行 #admin=admin,admin を見つけます。この行は、パスワードが admin のユーザー admin と、ロール admin を指定します。
   3. 先頭の # を削除し、行をアンコメントします。
   4. 最初の admin をユーザーの名前に置き換えます。
   5. 2 つ目の admin をユーザーのパスワードに置き換えます。
   6. 最後の admin はそのままにし、変更を保存します。

   注記

   Fuse 管理コンソールにアクセスし、 Camel ルート、ActiveMQ ブローカー、Web アプリケーションなどを監視および管理するには、Red Hat JBoss Fuse の起動後にブラウザーで

   http://localhost:8181/hawtio

   にアクセスします。

4. Red Hat JBoss Fuse Maven リポジトリー

   Maven を使用してプロジェクトをビルドするには、Maven settings.xml ファイルでアーティファクトの場所を指定します。
   次の JBoss Fuse Maven リポジトリーには Camel に必要な依存関係が含まれ、settings.xml ファイルに追加する必要があります。

   https://repo.fusesource.com/nexus/content/groups/public/

   Copy to Clipboard Toggle word wrap
   JBoss Fuse リポジトリーは JBoss Data Grid リポジトリーと平行して実行されます。
   JBoss Data Grid には、camel-jbossdatagrid コンポーネントに必要なすべてのアーティファクトをデプロイする Karaf 用の features.xml ファイルが含まれています。このファイルは、JBoss Fuse コンテナーディストリビューションには含まれていません。features.xml ファイルは jboss-datagrid-7.0.0-maven-repository/org/apache/camel/camel-jbossdatagrid/${version}/ にあります。JBoss Data Grid リポジトリーに必要な他の設定はありません。
   JBoss Fuse のインストールや初めて使用する場合の詳細は、Red Hat カスタマーポータルの Red Hat JBoss Fuse ドキュメントを参照してください。

手順5.3 JBoss Data Grid のインストール

• JBoss Data Grid のインストールに関する情報は、パートII「Red Hat JBoss Data Grid のダウンロードおよびインストール」を参照してください。JBoss EAP で Camel コンポーネントを実行するには、以下の JBoss Data Grid コンポーネントのみが必要になります。
  • JBoss Data Grid Maven リポジトリー。
  • The JBoss Data Grid Server パッケージ (Hot Rod を使用するため)。

手順5.4 JBoss EAP のインストール

1. Red Hat JBoss EAP をインストールして使用する前に、ご使用のシステムが 『Red Hat JBoss EAP インストールガイド』 に記載されている最低限の要件を満たしていることを確認してください。

2. アーカイブの展開

   Red Hat JBoss EAP は zip ファイルとしてパッケージ化されているため、アーカイブをシステムで展開するとインストールされます。適切なアーカイブツールを使用して、Red Hat JBoss EAP を完全なアクセス権限を持つディレクトリーで展開します。

   警告

   パス名に空白文字が含まれるフォルダーにアーカイブファイルを展開しないでください。たとえば、C:\Documents and Settings\Greco Roman\Desktop\JBoss では展開しないでください。

   さらに、パス名に特殊文字 #、%、^、または " が含まれるフォルダーにアーカイブファイルを展開しないでください。
3. アーカイブが展開されると、JBoss EAP が正常にインストールされます。インストールオプションの詳細は 『Red Hat JBoss EAP インストールガイド』を参照してください。
4. JBoss Data Grid がライブラリーモードで使用されている場合は 「JBoss EAP での JBoss Data Grid のデプロイ (ライブラリーモード)」 を参照し、必要な依存関係がインストールされていることを確認してください。
5. JBoss Data Grid がリモートクライアントサーバーモードで使用されている場合は 「JBoss EAP での JBoss Data Grid のデプロイ (リモートクライアントサーバーモード)」 を参照し、必要な依存関係がインストールされていることを確認してください。

手順10.2 キャッシュのデータ追加および削除

1. エントリーを追加し、key と value を希望のキーと値に置き換えます。

   cache.put("key", "value");

   Copy to Clipboard Toggle word wrap
2. キャッシュにエントリーが存在することを確認します。

   assertEquals(1, cache.size());
   assertTrue(cache.containsKey("key"));

   Copy to Clipboard Toggle word wrap
3. キャッシュからエントリーを削除します。

   Object v = cache.remove("key");

   Copy to Clipboard Toggle word wrap
4. エントリーがキャッシュに存在しないことを確認します。

   assertEquals("value", v);
   assertTrue(cache.isEmpty());

   Copy to Clipboard Toggle word wrap

手順10.3 キー値の追加と置換

• value をキーの値とするエントリー key を追加します。

  cache.put("key", "value");

  Copy to Clipboard Toggle word wrap

手順10.4 キー値の置換

1. 次のコードは、key および key2 という名前のキーを検索します。検索した 2 つのキーが見つからなかった場合、JBoss Data Grid は指定のキー名と値を持つ 2 つの新しいキーを作成します。

   cache.putIfAbsent("key", "newValue");
   cache.putIfAbsent("key2", "value2");

   Copy to Clipboard Toggle word wrap
2. 以下のコードは、格納されたキーの値が格納したい値と同じであることを確認します。

   assertEquals(cache.get("key"), "value");
   assertEquals(cache.get("key2"), "value2");

   Copy to Clipboard Toggle word wrap

手順10.5 データライフの調整

1. キーの lifespan 値を変更します。

   cache.put("key", "value", 5, TimeUnit.SECONDS);

   Copy to Clipboard Toggle word wrap
2. キャッシュにキーが含まれていることを確認します。

   assertTrue(cache.containsKey("key"));

   Copy to Clipboard Toggle word wrap
3. 割り当てられた lifespan 時間が期限切れになると、キーはキャッシュから削除されます。

   Thread.sleep(10000);
   assertFalse(cache.containsKey("key"));

   Copy to Clipboard Toggle word wrap

手順11.1 レプリケーションモードでクラスター化されたキャッシュを実行

1. 次のコマンドを用いて最初のノードを立ち上げます。

   $ java -cp target/classes/:target/dependency/* org.infinispan.quickstart.clusteredcache.replication.Node0

   Copy to Clipboard Toggle word wrap
2. 次のコマンドを用いて、2 つ目のノードを立ち上げます。

   $ java -cp target/classes/:target/dependency/* org.infinispan.quickstart.clusteredcache.replication.Node1

   Copy to Clipboard Toggle word wrap

手順11.2 ディストリビューションモードでクラスター化されたキャッシュを実行

1. 次のコマンドを用いて最初のノードを立ち上げます。

   $ java -cp target/classes/:target/dependency/* org.infinispan.quickstart.clusteredcache.distribution.Node0

   Copy to Clipboard Toggle word wrap
2. 次のコマンドを用いて、2 つ目のノードを立ち上げます。

   $ java -cp target/classes/:target/dependency/* org.infinispan.quickstart.clusteredcache.distribution.Node1

   Copy to Clipboard Toggle word wrap
3. 次のコマンドを用いて、3 つ目のノードを立ち上げます。

   $ java -cp target/classes/:target/dependency/* org.infinispan.quickstart.clusteredcache.distribution.Node2

   Copy to Clipboard Toggle word wrap

手順11.3 クラスターの設定

1. 新しいクラスターのデフォルト設定を追加します。
2. ネットワークの要件に従って、デフォルトのクラスター設定をカスタマイズします。カスタマイズは宣言的 (XML を使用) またはプログラム的に行います。
3. レプリケートされたデータグリッドまたは分散されたデータグリッドを設定します。

手順13.1 新しい RemoteCacheManager の設定

import org.infinispan.client.hotrod.RemoteCache;
import org.infinispan.client.hotrod.RemoteCacheManager;
import org.infinispan.client.hotrod.configuration.Configuration;
import org.infinispan.client.hotrod.configuration.ConfigurationBuilder;

Configuration conf = new 
ConfigurationBuilder().addServer().host("localhost").port(11222).build();
RemoteCacheManager manager = new RemoteCacheManager(conf);
RemoteCache defaultCache = manager.getCache();

import org.infinispan.client.hotrod.RemoteCache;
import org.infinispan.client.hotrod.RemoteCacheManager;
import org.infinispan.client.hotrod.configuration.Configuration;
import org.infinispan.client.hotrod.configuration.ConfigurationBuilder;

Configuration conf = new 
ConfigurationBuilder().addServer().host("localhost").port(11222).build();
RemoteCacheManager manager = new RemoteCacheManager(conf);
RemoteCache defaultCache = manager.getCache();

1. ConfigurationBuilder() コンストラクターを使用して新しい設定ビルダーを作成します。.addServer() メソッドは、.host(<hostname|ip>) プロパティーと .port(<port>) プロパティーで設定されたリモートサーバーを追加します。
2. 指定された設定を使用して新しい RemoteCacheManager を作成します。
3. リモートサーバーからデフォルトキャッシュを取得します。

手順13.2 新しい組み込みキャッシュマネージャーの作成

1. 設定 XML ファイルを作成します。たとえば、クラスパス上 ( resources/ フォルダー内) に my-config-file.xml ファイルを作成し、このファイルに設定情報を追加します。
2. 設定ファイルを使用してキャッシュマネージャーを作成するには、以下のプログラムを使用した設定を使用します。

   EmbeddedCacheManager manager = new DefaultCacheManager("my-config-file.xml");
   Cache defaultCache = manager.getCache();

   Copy to Clipboard Toggle word wrap

手順13.3 CDI を使用した新規 EmbeddedCacheManager の作成

1. 次のようにデフォルト設定を指定します。

   public class Config
      @Produces
      public EmbeddedCacheManager defaultCacheManager() {
         ConfigurationBuilder builder = new ConfigurationBuilder();          
         Configuration configuration = builder.eviction().strategy(EvictionStrategy.LRU).maxEntries(100).build();
         return new DefaultCacheManager(configuration);
      }
   }

   Copy to Clipboard Toggle word wrap
2. デフォルトのキャッシュマネージャーを挿入します。

   <!-- Additional configuration information here -->
   @Inject
   EmbeddedCacheManager cacheManager;
   <!-- Additional configuration information here -->

   Copy to Clipboard Toggle word wrap