Red Hat Training
A Red Hat training course is available for Red Hat JBoss Data Virtualization
インストールガイド
インストール担当チーム向けのガイド
Red Hat Customer Content Services
概要
第1章 作業を開始する前に
1.1. データのバックアップ
警告
1.2. 変数名: EAP_HOME
EAP_HOME は、JBoss Data Virtualization がデプロイされた Red Hat JBoss Enterprise Application Platform インストールのルートディレクトリーを示しています。
第2章 プラットフォームの要件
2.1. アーキテクチャーと必要性の評価
- 2 GB の RAM が最低でも必要ですが、大型のモデルにはより多くの RAM が必要です。
- 最新のプロセッサー
- インストールされた製品ファイルには 500 MB のディスク領域が必要です。
- モデルプロジェクトや関連するアーティファクトには 2 GB 以上の領域が必要です。
- 16 GB の JVM メモリーサイズ。
- 最新のマルチコア (デュアル以上) プロセッサーまたは最新のマルチコアプロセッサーを持つマルチソケットシステム
- JBoss のサーバー製品と DV コンポーネントには 20 GB 以上のディスク領域が必要です:
- インストールされた製品のファイルには 1 GB のディスクが必要です。
- ログファイルとデプロイされたアーティファクトには 5 GB 以上が必要です。
- BufferManager の maxBufferSpace には 50 GB (デフォルト) が必要です。
- Modeshape (リポジトリー) が使用される場合、ファイル領域を最低でも 5 GB 増やす必要があります。
- 同時性: 最大セッション、トランスポートスレッドプール、エンジンスレッドプール/エンジン (特に最大アクティブ値) の設定、および接続プールサイズを考慮します。
- データボリューム: バッチサイズを基にデータソースから読み取られるデータの量を考慮します。デフォルトのプロセッサーバッチサイズは 256 で、行ごとに約 2k バイトをターゲットとし、約512kb のサイズでシステムを通過します。しかし、メモリー容量の多いマシンでは、バッチサイズを 512 に増加し、バッチごとにサイズを約 1mb にすることが推奨されます。
- 計画処理: クエリー計画を基に行われるデータの追加処理を考慮します。通常、これには追加のメモリーが必要です (ソートなど)。
- サーバーは調整されているため (スレッドプール、接続プールなど)、待機または最大のスループットなしで各クエリーは実行されます。
- 計画ではデータソースごとに 1 つのソースクエリーがあります (複雑なクエリーが増えると、さらに多くのメモリーが必要になります)。
- Teiid と同じ JVM で実行されている他のアプリケーションはありません (同じ JVM で他のアプリケーションが実行される場合は、追加のメモリー要件を考慮する必要があります)。
- 非トランザクションの直線的な読み取りを実行します (Teiid は、事前にバッチフェッチを行いますが、これはメモリの要件が増えるため、バッチタイプが 2 倍になります)。
- デフォルトのプロセッサーバッチサイズは 512 に設定されています (256 のデフォルトから変更)。これは、バッチのオーバーヘッドを低減するため、メモリー容量の多いマシンで推奨されます。
(同時クエリー) * (4 * バッチバイト) + (2 * (計画ごとのソースクエリーの数 * ソースバイトの概算)) + オーバーヘッド になります。説明は次のとおりです。
- 同時クエリー
- バッチバイト: システムを通過するバッチを表します。256 バッチサイズをデフォルトで使用するとそのバイトサイズは約 512 kb になります。しかし、推奨される 512 バッチサイズを使用すると、各バッチは約 1mb になります。バッチバイトを 2 倍にするのは、別のバッチのプロセス中に部分的なバッチが読み出される場合にワークアイテムでバッチを格納するためです。
- 2 * バッチバイト
- 計画ごとのソースクエリー: クエリーのデータソースの数ですが、前提を基に制限されます。
- 4 * バッチバイトのオンヒープのサイズ
- オーバーヘッド: AS (約 300mb) の調整、追加の Teiid オーバーヘッド (キャッシュ、計画など)、および接続プールのオーバヘッドが含まれます。他の項目を算出するのは難しいため約 300mb のみが使用されますが、パフォーマンスを向上させるにはこれを検討する必要があります。
- (同時クエリー) * (4 * バッチバイト) + (2 * ソースバイト) * ソースクエリーの数 + 300mb
- (同時クエリー) * (4 * 1mb) + (2 * 512kb) * ソースクエリーの数 + 300mb
- (同時クエリー) * (4mb) + (1mb) * ソースクエリーの数 + 300mb
- 同時実行の数 * (5mb) * #ソースクエリー + 300mb
表2.1 設定
|
同時実行 ソースクエリーの数
|
100
|
200
|
|---|---|---|
|
2
|
1.3 gb
|
2.3 gb
|
|
5
|
2.8 gb
|
5.3 gb
|
|
10
|
5.3 gb
|
10.3 gb
|
- maxActivePlans を最大同時クエリーに設定します。
- maxThreads が maxActivePlans の 2 倍になるように設定します (トランザクションが使用される場合は 3 倍)。
- 各データソースの最大プールサイズが最大同時ソースクエリーと同じになるように設定します (最大同時maxThreads が maxActivePlans の 5 倍クエリーが最小限になりますが、複数のソースクエリーが作成される原因となるサブクエリーがある場合、状況に応じて最大プールサイズを増加する必要があります)。
- すべての調整を行った後、サーバーのメモリー容量に余裕がある場合、processBatchSize および connectorBatchSize を増やし (例: それぞれ 512 および 1024)、データソースおよびエンジンからのスループットを増加することを検討してください。メモリー不足の場合は、JVM サイズを増やしてください。6GB 以下のメモリーを持つマシンは 512 のままにし、これよりも大きなメモリーを持つマシンにはより大きなサイズを使用してください。
第3章 製品のダウンロード
3.1. Red Hat カスタマーポータル
3.2. JBoss Data Virtualization インストーラーのダウンロード
.jar アーカイブを使用してグラフィカルインストーラーを実行できます。ここでは、アーカイブをダウンロードする手順を示します。
- Red Hat カスタマーポータル https://access.redhat.com/ でアカウントを設定する必要があります。
- Red Hat のサブスクリプションが最新の状態であることを確認してください。
- サポートされる設定を確認し、ご使用のシステムがサポートされるようにしてください。
- インストールディレクトリーの管理権限があることを確認してください。
- Microsoft Windows サーバーでショートカットを使用する場合、JAVA_HOME と PATH が環境プロパティーに設定されている必要があります。
- Java 6、7 または 8 の JDK が必要です。(Red Hat SSO をお使いになる場合には Java 7 以上が必要になることに注意してください。Java 7 は Impala、Hive および HBase データソースの最小要件でもあります。)
- オプション: JBoss Data Virtualization インストーラーに同梱されている Red Hat JBoss EAP のバージョンを使用しない場合には Red Hat JBoss Enterprise Application Platform 6.4.x が必要です。
手順3.1 JBoss Data Virtualization インストーラーのダウンロード
Red Hat カスタマーポータルにログインします。
- ブラウザーのアドレスバーに https://access.redhat.com/ と入力します。
- ログインをクリックし、Red Hat Login と Password を入力してカスタマーポータルにアクセスします。アカウントをお持ちでない場合はアカウントを登録する必要があります。
JBoss Data Virtualization インストーラーをダウンロードします。
- ダウンロードをクリックし、Red Hat JBoss Data Virtualization をクリックします。
- Red Hat JBoss Data Virtualization [バージョン] Installer オプションの横にある Download をクリックします。
- ファイルを保存します。
3.3. ダウンロードされたファイルの検証
手順3.2 Red Hat Enterprise Linux でのファイルチェックサムの検証
ダウンロードされたファイルのチェックサム値を取得
- https://access.redhat.com/jbossnetwork/ へ移動し、必要な場合はログインします。
- Product で製品を選択し、Version でバージョンを指定します。
- 検証するパッケージを選択すると、Software Details ページに移動します。
- MD5 と SHA-256 のチェックサム値を書き留めておきます。
ファイルでチェックサムツールを実行
- ターミナルウインドウで、ダウンロードされたファイルが含まれるディレクトリーへ移動します。
md5 downloaded_fileを実行します。shasum downloaded_fileを実行します。
以下は出力例になります。[localhost]$ md5 jboss-dv-installer-[VERSION]-redhat-[VERSION].jar MD5 (jboss-dv-installer-[VERSION]-redhat-[VERSION].jar) = 0d1e72a6b038d8bd27ed22b196e5887f [localhost]$ shasum jboss-dv-installer-[VERSION]-redhat-[VERSION].jar a74841391bd243d2ca29f31cd9f190f3f1bdc02d jboss-dv-installer-[VERSION]-redhat-[VERSION].jar
チェックサム値を比較
md5およびshasumコマンドによって返されたチェックサム値と、Software Details ページに表示された対応する値を比較します。- 2 つのチェックサム値が同じでない場合は、再度ファイルをダウンロードします。チェックサム値が異なる場合、ダウンロード中にファイルが破損したか、サーバーへアップロードされた後に変更が加えられたことを意味します。数回ダウンロードしてもチェックサムの検証に失敗する場合は、Red Hat サポートまでご連絡ください。
- 2 つのチェックサム値が同じであれば、ダウンロードされたファイルを安全に使用できます。
ダウンロードされたファイルの整合性が検証されます。
注記
第4章 Maven リポジトリー
4.1. 提供される Maven リポジトリー
settings.xml ファイルの場所を指定した場合、Maven はオンラインリポジトリーを使用するよう設定されています。
重要
4.2. ファイルシステムリポジトリーを使用するよう Maven を設定
Red Hat JBoss EAP DV の Maven リポジトリーはオンライン上にあるため、ローカルにダウンロードし、インストールする必要はありません。しかし、JBoss EAP の Maven リポジトリーをローカルでインストールする場合は、ローカルファイルシステム上のインストール、Apache Web Server 上のインストール、および Maven リポジトリーマネージャーを用いたインストールの 3 つの方法を使用できます。この例では、ローカルのファイルシステムへ JBoss EAP 6 の Maven リポジトリーをダウンロードする手順を取り上げます。この方法は、開発環境で Maven の知識を深めることができますが、チームによる本番環境での使用は推奨されません。
手順4.1
- ダウンロード ボタンをクリックし、リポジトリーが含まれる
.zipファイルをダウンロードします。 - ローカルファイルシステム上の Zip 形式のファイルを希望のディレクトリーで展開します。
- 展開されていないリポジトリーのエントリーを Maven の
settings.xmlファイルに追加します。以下のコード例には、リポジトリーがあるプロファイルと、プロファイルのアクティベートエントリーが含まれます。<?xml version="1.0" encoding="UTF-8" standalone="no"?> <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/xsd/settings-1.0.0.xsd"> <localRepository/> <profiles> <!-- Profile with local repositories required by Data Virtualization --> <profile> <id>dv-local-repos</id> <repositories> <repository> <id>dv-[VERSION]-repository</id> <name>DV [VERSION] GA Repository</name> <url>file://<!-- path to the repository -->/jboss-dv-[VERSION].redhat-[VERSION]-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> </repositories> <pluginRepositories> <pluginRepository> <id>dv-[VERSION].GA-redhat-[VERSION]-repository</id> <name>DV [VERSION] GA Repository</name> <url>file://<!-- path to the repository -->/jboss-dv-[VERSION].redhat-[VERSION]-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> <!-- Activation of the Data Virtualization profile --> <activeProfile>dv-local-repos</activeProfile> </activeProfiles> </settings>
Maven リポジトリーがダウンロードされ、ローカルファイルシステムで展開された後、Maven の settings.xml ファイルに登録されます。Maven の構築を実行するときに使用できます。
プロジェクトをビルドまたはデプロイするときに、以下のエラーの 1 つまたは両方が発生し、失敗します。
[ERROR] Failed to execute goal on project PROJECT_NAMECould not find artifact ARTIFACT_NAME
キャッシュされたローカル Maven リポジトリーに古いアーティファクトが含まれている可能性があります。
この問題を解決するには、キャッシュされたローカルディレクトリーを削除します。このディレクトリーは Linux の場合は ~/.m2/repository/ ディレクトリー、Windows の場合は %SystemDrive%\Users\USERNAME\.m2\repository\ ディレクトリーになります。mvn clean install -U を実行します。これにより、次回構築を行うと Maven が必要なアーティファクトの適切なバージョンをダウンロードするようになります。
Maven 設定を更新しても、この設定は JBoss Developer Studio には反映されません。
Maven の settings.xml ファイルの編集時に JBoss Developer Studio が実行されていると、この設定は JBoss Developer Studio には反映されません。

図4.1 Maven ユーザー設定の更新
4.3. オンラインリポジトリーを使用するよう Maven を設定
settings.xml ファイルの場所を指定した場合、Maven はすでにオンラインリポジトリーを使用するよう設定されています。
手順4.2 オンラインリポジトリーを使用するよう Maven を設定
- 以下のコードサンプルのように、オンラインリポジトリーのエントリーを Maven の
settings.xmlファイルに追加します。<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 with online repositories required by Data Virtualization --> <profile> <id>dv-online-profile</id> <repositories> <repository> <id>jboss-ga-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>jboss-ga-plugin-repository</id> <url>http://maven.repository.redhat.com/techpreview/all</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <!-- Activation of the Data Virtualization profile --> <activeProfile>dv-online-profile</activeProfile> </activeProfiles> </settings> - JBoss Developer Studio の稼働中に
settings.xmlファイルを変更した場合は、IDE の Maven 設定を更新する必要があります。メニューで Window → Preferences と選択します。 Preferences ウインドウで Maven を展開し、User Settings を選択します。Update Settings ボタンをクリックし、JBoss Developer Studio の Maven ユーザー設定を更新します。
図4.2 Maven ユーザー設定の更新
Red Hat JBoss 製品向けに提供されるオンラインリポジトリーを使用するよう Maven が設定されます。
重要
- Missing artifact ARTIFACT_NAME
- [ERROR] Failed to execute goal on project PROJECT_NAME; Could not resolve dependencies for PROJECT_NAME
~/.m2/repository/ ディレクトリー、Windows の場合は %SystemDrive%\Users\USERNAME\.m2\repository\ ディレクトリーになります。これにより、次回の構築中に Maven が必要なアーティファクトの適切なバージョンをダウンロードするようになります。
4.4. 依存関係管理
pom.xml ファイルに追加する必要があります。BOM および親 POM ファイルを追加して、適切なバージョンのプラグインと提供された Maven リポジトリーからの推移的依存関係が確実にプロジェクトに含まれるようにします。
org.jboss.dv.component.management:dv-parent-[VERSION].pom です。
org.jboss.dv.component.management:dv-dependency-management-all-[VERSION].pom です。
4.5. Red Hat JBoss Data Virtualization に Maven 依存関係を使用
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<!-- Example POM file using the DV 6.3.0 and EAP 6.4 component versions.
- Parent is set to the DV 6.3.0 parent management POM, which will
- bring in the correct toolchain (plugin) versions.
- DependencyManagement dependencies include the DV 6.3.0 and EAP 6.4
- BOMs - which will bring in the correct compile-time (and other
- scoped) versions.
-->
<name>Example POM for DV 6.3.0</name>
<groupId>org.jboss.dv</groupId>
<artifactId>dv-example</artifactId>
<version>0.0.1</version>
<packaging>pom</packaging>
<parent>
<!-- DV version (parent) -->
<groupId>org.jboss.dv.component.management</groupId>
<artifactId>dv-parent</artifactId>
<version>2.3.0.redhat-10</version>
</parent>
<dependencyManagement>
<dependencies>
<!-- DV BOM -->
<dependency>
<groupId>org.jboss.dv.component.management</groupId>
<artifactId>dv-dependency-management-all</artifactId>
<version>2.3.0.redhat-10</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
</project>
4.6. オフラインモード
4.6.1. カスタムオフラインリポジトリーのユースケース
features-maven-plugin プラグインを利用してカスタムオフラインリポジトリーを生成することです。
4.6.2. Maven プロジェクトのリポジトリーのダウンロード
pom.xml ファイルがある) から以下の Maven コマンドを実行できるはずです。
mvn org.apache.maven.plugins:maven-dependency-plugin:2.8:go-offline -Dmaven.repo.local=/tmp/cheese
/tmp/cheese ディレクトリーにプロジェクトをビルドするために必要な Maven 依存関係およびプラグインがダウンロードされます。
4.6.3. オフラインリポジトリーの生成
ProjectDir/custom-repo ディレクトリーへ移動してから、以下の Maven コマンドを入力します。
mvn generate-resources
ProjectDir/custom-repo/target/features-repo
第5章 事前に必要なコンポーネントのインストール
5.1. Red Hat Enterprise Linux に OpenJDK をインストール
手順5.1 Red Hat Enterprise Linux に OpenJDK をインストール
ベースチャンネルのサブスクライブ
RHN ベースチャンネルから OpenJDK を取得します (Red Hat Enterprise Linux のインストールはデフォルトでこのチャンネルにサブスクライブされています)。パッケージのインストール
yum ユーティリティを使用して OpenJDK をインストールします:yum install java-1.7.0-openjdk-develOpenJDK がシステムデフォルトであることを確認
以下の手順に従って、正しい JDK がシステムデフォルトとして設定されていることを確認します。- root で
javaの alternatives コマンドを実行します。/usr/sbin/alternatives --config java
/usr/lib/jvm/jre-1.7.0-openjdk/bin/javaを選択します。- 同様に、
javacの alternative コマンドを実行します。/usr/sbin/alternatives --config javac
/usr/lib/jvm/java-1.7.0-openjdk/bin/javacを選択します。
5.2. Maven のインストール
以下のソフトウェアがインストールされている必要があります。
- 圧縮ファイルの内容を抽出するアーカイブツール。
- Open JDK。
手順5.2 Maven のインストール
Maven のダウンロード
- ブラウザーのアドレスバーに http://maven.apache.org/download.cgi を入力します。
apache-maven-[latest-version]ZIP ファイルをダウンロードし、ハードドライブに保存します。
Maven のインストールおよび設定
Red Hat Enterprise Linux の場合
- Maven をインストールするディレクトリーに ZIP ファイルを展開します。
- ターミナルで .bash_profile ファイルを開きます:
vi ~/.bash_profile - M2_HOME 環境変数をファイルに追加します。
export M2_HOME=/path/to/your/maven
- さらに、M2 環境変数をファイルに追加します。
export M2=$M2_HOME/bin
- ファイルに PATH 環境変数を追加します。
export PATH=$M2:$PATH
- JAVA_HOME が JDK の場所に設定されるようにします。例は次のとおりです。
export JAVA_HOME=/usr/lib/jvm/java-1.7.0-openjdk.x86_64
- $JAVA_HOME/bin が PATH 環境変数に含まれるようにします。
- ファイルを保存して、テキストエディターを終了します。
source ~/.bash_profileコマンドを実行して変更が反映されるようにします。- 以下のコマンドを実行して、ご使用のマシンに Maven が正常にインストールされたことを確認します。
mvn --version
Microsoft Windows の場合
- Maven をインストールするディレクトリーに ZIP ファイルを展開します。アーカイブからサブディレクトリー
apache-maven-[latest-version]が作成されます。 - Start+Pause|Break を押します。System Properties ダイアログボックスが表示されます。
- Advanced タブをクリックし、Environment Variables をクリックします。
- System Variables で Path を選択します。
- Edit をクリックし、区切り文字にセミコロンを使用して Maven のパスを 2 つ追加します。
- Add the M2_HOME variable and set the path to
C:\path\to\your\Maven. - M2 変数を追加し、値を %M2_HOME%\bin に設定します。
- Path 環境変数を更新または作成します。
- %M2% 変数を追加し、コマンドラインから Maven を実行できるようにします。
- 変数 %JAVA_HOME%\bin を追加し、適切な Java インストールへのパスを設定します。
- OK をクリックして、System Properties ダイアログボックスを含むすべてのダイアログボックスを閉じます。
- Windows のコマンドプロンプトを開き、以下のコマンドを実行してご使用のマシンに Maven が正常にインストールされたことを確認します。
mvn --version
マシンに Maven が正常にインストールおよび設定されます。
第6章 製品のインストール
6.1. Red Hat JBoss Data Virtualization のインストール方法
- グラフィカルモード: グラフィカルモードでは、Red Hat JBoss Data Virtualization のインストールおよび設定をステップごとに説明するグラフィカルウィザードが実行されます。インストーラーを使用して、クイックスタートや Maven リポジトリーなどの追加設定を行うこともできます。
- テキストモード: テキストモードでもインストーラーを実行できます。テキストモードでは、Red Hat JBoss Data Virtualization のインストールおよび設定をステップごとに説明します。
- 自動化スクリプトモード: 自動化スクリプトを使用すると Red Hat JBoss Data Virtualization の同一インスタンスを複数インストールできます。この自動化スクリプトは、最初のインストールインスタンスの後に生成されます。自動化インストールについての詳細は、本書の末尾で扱われます。
6.2. JBoss Data Virtualization のインストール: グラフィカルインストール
手順6.1 JBoss Data Virtualization のインストール
- ターミナルウインドウを開き、GUI インストーラーをダウンロードした場所に移動します。
- 以下のコマンドを実行して GUI インストーラーを起動します。
java -jar jboss-dv-VERSION-installer.jar
- ダイアログボックスが表示された後に、使用許諾契約書が表示されます。契約の内容に同意する場合は I accept the terms of this license agreement をクリックし、Next クリックします。
- Red Hat JBoss EAP がサーバーにインストールされている場所を Red Hat JBoss Data Virtualization に通知するか、製品にバンドルされているためインストールされていない場合は、新しい場所を指定します (Red Hat JBoss EAP がすでにインストールされている場合は、6.4.x の最新バージョンのパッチが適用されていることを確認します)。Next をクリックします。
- Teiid インストールおよび Modeshape インストールにチェックマークが付いていることを確認し、Next をクリックします。
- 新しい EAP 管理者、Dashboard 管理者、Teiid データアクセスユーザー、および ModeShape ユーザーを作成するよう要求され、OData のアクセスを有効にするかどうかを問われます。これらの管理者とユーザーが作成されると、EAP 管理者は ManagementRealm へ追加され、管理コンソールへアクセスするために使用できます。他のユーザーは ApplicationRealm に追加され、JBoss Data Virtualization の特定コンポーネントへアクセスするために使用できます。新しいユーザー名とパスワードを適切なフィールドに入力し、Next をクリックします。必ずこれらのパスワードをすべて記憶するようにしてください。これらのパスワードはシステムの異なる部分へのアクセスを可能にします。EAP アカウントおよびパスワードは EAP サーバーの管理、Dashboard のパスワードは Web インターフェースに関連する管理機能、Teiid データアクセスユーザーおよび ModeShape ユーザーは標準的なユーザーアクセスを可能にします。ユーザー名と同じパスワードは使用できません。また、パスワードは 8 文字以上である必要があり、英字、数字、および英数字以外の文字がそれぞれ 1 文字以上含まれる必要があります。
- Red Hat JBoss Data Virtualization は、デフォルト設定または追加設定オプションでインストールできます。ここでは、デフォルトのみを使用するため、Perform default configuration を選択し、デフォルトのオプションで Red Hat JBoss Data Virtualization をインストールします。Next をクリックします。
- Configure password vault の画面が表示されます。6 文字以上のパスワードを入力します。Next をクリックします。
注記
デフォルトの H2 データベースは本番環境のデータベースには適していません。テストおよび評価環境のみで使用してください。 - インストールの概要が表示されます。Next をクリックしてインストールを開始します。インストールには時間がかかることがあります。すべてのコンポーネントがインストールされたら Next をクリックします。
- 自動スクリプトを生成したい場合は Generate an automatic installation script をクリックします。これを選択すると、毎回ウィザードを使用しなくても初回のインストールで指定した設定を使用して、製品を迅速に再インストールしたり、大量にデプロイしたりすることができます。
注記
Red Hat JBoss Data Virtualization 6.0 用に作成された自動インストールスクリプトは Red Hat JBoss Data Virtualization 6.1 では動作しないため注意してください。 - Done をクリックし、インストーラーを終了します。
Red Hat JBoss Data Virtualization が正常にインストールされ、設定されます。
注記
警告
6.3. テキストベースのインストーラーを使用した JBoss Data Virtualization のインストール
カスタマーポータルから Red Hat JBoss Data Virtualization の jar ファイルをダウンロードしておく必要があります。
手順6.2 JBoss Data Virtualization のインストール
- ターミナルウインドウを開き、GUI インストーラーをダウンロードした場所に移動します。
- 以下のコマンドを入力し、インストールプロセスを開始します。
java -jar jboss-dv-VERSION-installer.jar -console
- ターミナルに表示されるインストールプロンプトに従います。デフォルト設定でインストールするか、追加の設定を行います。
- 最後の手順で、自動インストールスクリプトを生成します。このスクリプトを使用すると、ヘッドレスインストールを実行したり、複数のインスタンスで同一インストールを実行したりすることができます。
Red Hat JBoss Data Virtualization が正常にインストールされ、設定されます。
6.4. JBoss Data Virtualization 開発ツールのインストール
以下のソフトウェアがインストールされている必要があります。
- Red Hat JBoss Developer Studio (『Red Hat JBoss Developer Studio Installation Guide』 を参照してください)。
- 圧縮ファイルの内容を抽出するアーカイブツール。
- Open JDK (『Red Hat JBoss Data Virtualization インストールガイド』を参照) またはサポートされる他の Java 仮想マシン
手順6.3 JBoss Developer Studio Integration Stack のインストール
- Red Hat JBoss Developer Studio を起動します。
- Red Hat JBoss Developer Studio でメインメニューから Help > Install New Software... アクションをクリックします。
- Available Software ページで Add ... ボタンをクリックします。
- Add Repository ダイアログで以下の詳細を入力します。Name フィールドに JBDSIS (または別の一意な名前) を入力します。Location フィールドに https://devstudio.redhat.com/9.0/stable/updates/integration-stack/earlyaccess/ を入力します。
- OK をクリックします。
- アップデートサイトのツリービューで JBoss Data Virtualization Development フォルダーとすべての子を選択します。
注記
JBDSIS がすでにインストールされている場合は、次の手順に進みます。What is already installed リンクをクリックすると、JDBSIS がマシンにインストールされているかを確認できます。 - Next をクリックします。
- 追加の依存関係とライセンス契約に同意し、Finish をクリックして完了します。
Teiid Designer および ModeShape Tools が正常にインストールされます。
第7章 製品の開始および停止
7.1. JBoss Data Virtualization の起動
以下のソフトウェアがインストールされている必要があります。
- Red Hat JBoss Data Virtualization
手順7.1 JBoss Data Virtualization の起動
JBoss EAP サーバーの起動
JBoss EAP server を起動すると JBoss Data Virtualization を実行できます。以下のように JBoss EAP server を起動します。Red Hat Enterprise Linux
ターミナルを開き、以下のコマンドを入力します。$ EAP_HOME/bin/standalone.shMicrosoft Windows
ターミナルを開き、以下のコマンドを入力します。$ EAP_HOME\bin\standalone.bat
注記
EAP_HOME/MODE/log/server.log を確認します。管理コンソール を開き、登録された JBoss EAP 管理ユーザーのユーザー名とパスワードでログインします。管理コンソールの使用についての詳細は『Red Hat JBoss Enterprise Application Platform 管理および設定ガイド』を参照してください。
注記
7.2. JBoss EAP 6 を管理対象ドメインとして起動
ドメイン内のサーバーグループのスレーブサーバーを起動する前にドメインコントローラーを起動する必要があります。最初に、この手順をドメインコントローラーで使用した後に、関連するホストコントローラーおよびドメインに関連する他のホストに対して使用してください。開始する前に、Red Hat JBoss EAP ドキュメント (https://access.redhat.com/documentation/en/red-hat-jboss-enterprise-application-platform/) を参照してください。
手順7.2 プラットフォームサービスを管理対象ドメインとして起動
Red Hat Enterprise Linux の場合
コマンドEAP_HOME/bin/domain.shを実行します。Microsoft Windows Server の場合
コマンドEAP_HOME\bin\domain.batを実行します。他のパラメーターを起動スクリプトに渡す (任意)
起動スクリプトに使用できるすべてのパラメーターを表示するには、-hパラメーターを使います。
JBoss EAP 6 管理対象ドメインインスタンスが起動します。
7.3. JBoss Data Virtualization の停止
注記
サーバーがシャットダウンします。シャットダウンには数分かかることに注意してください。
第8章 ドメインモード
8.1. ドメインモードでのインストール
- 「Domain」(ドメイン) モードでサーバーを起動するには、クラスターの一部になるすべてのサーバーに Red Hat JBoss Data Virtualization をインストールします。それらのサーバーの 1 つを「マスター」ドメインコントローラーとして選択します。(残りのサーバーは、すべての管理操作に関連して「マスター」ドメインコントローラーに接続するスレーブになります。)
- すべてのサーバーを設定したら、「マスター」ノードを起動します:
/bin/domain.sh - 「スレーブ」ノードを起動します:
/bin/domain.shスレーブノードは「マスター」ノードからそれぞれのドメイン設定の設定情報を取得します。「JBoss EAP 6 を管理対象ドメインとして起動」セクションを参照してください。 - すべてのサーバーが実行されたら、「マスター」ノードで以下のコマンドを実行してインストールを完了し、ドメインモードで実行します:
/bin/jboss-cli.sh --file=[JBOSS_HOME_DIR]/cli-scripts/teiid-domain-mode-install.cliこれはドメイン (クラスター) のインストールごとに 1 回のみ実行する必要があります。このスクリプトは Red Hat JBoss Data Virtulization を ha および full-ha プロファイルでインストールします。さらに、HA プロファイルを開始するために main-server-group を再設定します。ドメインモードに入ると、リソースをドメイン/デプロイメントディレクトリーにドロップすることでそれらを静的にデプロイすることができないため、このスクリプトは、CLI インターフェースでデフォルトリソース (ファイル、ldap、salesforce および ws connector など) をデプロイします。 - Red Hat JBoss Data Virtualization を HA 以外のプロファイルでインストールする必要がある場合は、インストールの前に teiid-domain-mode-install.cli ファイルを編集し、プロファイル、ソケットバインディングおよびサーバーグループに適宜変更を加えます。
- VDB がデプロイされると、ユーザーはそれぞれの JDBC アプリケーションを Red Hat JBoss Data Virtualization に接続できるようになります。
注記
第9章 JBoss Data Grid キャッシュのインストール
9.1. JBoss Data Grid アダプターの設定
docs/teiid/datasources/infinispan/ディレクトリーへ移動します。add-infinispan-cache-translator.cliまたはadd-infinispan-cache-dsl-translator.cliのスクリプトを実行します。
第10章 ODBC サポート
10.1. はじめに
10.1.1. JBoss Data Virtualization と ODBC
警告
10.2. Red Hat Enterprise Linux に ODBC ドライバーをインストール
10.2.1. Red Hat Enterprise Linux に ODBC ドライバーをインストール
前提条件
- 管理者権限が必要です。
手順10.1 Red Hat Enterprise Linux に ODBC ドライバーをインストール
ドライバーのダウンロード
https://access.redhat.com/jbossnetwork/ から適切な ODBC ドライバーパッケージ (jboss-dv-psqlodbc-[version]-X.rpm) をダウンロードしてください。パッケージのインストール
sudo yum localinstallを実行します。jboss-dv-psqlodbc-[version]-X.rpm
注記
10.2.2. ODBC 環境の設定
環境の設定
Run the/opt/redhat/jboss-dv/v6/psqlodbc/etc/setenv.shスクリプトを実行します。[localhost etc]$ ./setenv.sh
このスクリプトは必要なディレクトリーをLD_LIBRARY_PATHおよびPATH環境変数へ追加します。このスクリプトは、ドライバーを使用するたびに実行する必要があります。
10.2.3. Linux インストールの DSN の設定
/opt/redhat/jboss-dv/v6/psqlodbc/etc/odbc.iniファイルを編集し、適切なユーザー名、パスワードおよびデータベースを適用して更新します。データベース名は VDB 名です。JBoss Data Virtualization では、ODBC はデフォルトで35432ポートで有効になっています。
10.3. Microsoft Windows に ODBC ドライバーをインストール
10.3.1. Microsoft Windows に ODBC ドライバーをインストール
前提条件
- 管理者権限が必要です。
手順10.2 Microsoft Windows に ODBC ドライバーをインストール
- https://access.redhat.com/jbossnetwork/ から適切なドライバーパッケージ (
jboss-dv-psqlodbc-[バージョン]-X.zip) をダウンロードしてください。 - インストールパッケージを展開します。
jboss-dv-psqlodbc-[version]-X.msiファイルをダブルクリックしてインストーラーを起動します。- インストーラーウィザードが表示されます。Next をクリックします。
- 使用許諾契約書が表示されます。契約書の内容に同意する場合は I accept the terms in the License Agreement をクリックし、Next をクリックします。
- 表示されたデフォルト以外のディレクトリーにインストールしたい場合は、Browse ボタンをクリックし、ディレクトリーを選択します。Next をクリックします。
- 確認画面が表示されます。選択した内容を確認し、正しければ Next をクリックしてインストールを開始します。
- インストールが終了したら、インストールプロセスの終了を知らせる画面が表示されます。Finish をクリックしてウィザードを終了します。
注記
10.3.2. Windows インストールの DSN の設定
手順10.3 Windows インストールの DSN の設定
- ODBC ドライバーの基本オプションを設定します。
- ODBC ドライバーのデータソースオプションを設定します。
- ODBC ドライバーのグローバルオプションを設定します。
10.4. Solaris に ODBC ドライバーをインストール
10.4.1. Solaris に ODBC ドライバーをインストール
前提条件
- 管理者権限が必要です。
手順10.4 Solaris に ODBC ドライバーをインストール
ドライバーのダウンロード
https://access.redhat.com/jbossnetwork/ から適切な ODBC ドライバーパッケージ (jboss-dv-psqlodbc-[VERSION]-X.zip) をダウンロードしてください。インストールパッケージの展開
/optディレクトリーでインストールパッケージを展開します。PATH プロパティーの設定
ドライバーを展開したディレクトリーから ODBC バイナリーが使用されるよう PATH プロパティーを設定します。$ export PATH = $PATH:/opt/redhat/jboss-dv/v6/psqlodbc/bin環境変数の設定
既存の odbc.ini に ODBCINI 環境変数を設定します。$ export ODBCINI=/opt/redhat/jboss-dv/v6/psqlodbc/etc/odbc.ini注記
Solaris ターミナルとして Bourne Shell を使用している場合、上記 2 つのエクスポートコマンドを ~/.profile ファイルに追加すると、毎回実行する必要がなくなります。同様に、Bash を使用している場合は ~/.bash_profile ファイルに追加します。
10.4.2. Solaris インストールの DSN の設定
/opt/redhat/jboss-dv/v6/psqlodbc/etc/odbc.iniファイルを編集し、適切なユーザー名、パスワードおよびデータベースを適用して更新します。データベース名は VDB 名です。JBoss Data Virtualization では、ODBC はデフォルトで35432ポートで有効になっています。
10.5. ODBC の設定
10.5.1. Microsoft Windows での ODBC オプションの設定
前提条件
- 管理権限を使用してワークステーションにログインする必要があります。
- コントロールパネルのデータソース (ODBC) アプレットを使用して新しいデータソース名が追加されている必要があります。設定する各データソース名は Teiid System 内の 1 つの VDB のみにアクセスできます。複数の VDB を利用できるようにするには、複数のデータソース名を設定する必要があります。
手順10.5 Microsoft Windows でのデータソース名 (DSN) の設定
- Start メニューから Settings - Control Panel と選択します。
- Control Panel が表示されます。Administrative Tools をダブルクリックします。
- Data Sources (ODBC) をダブルクリックします。
- ODBC Data Source Administrator アプレットが表示されます。追加する DSN のタイプに関連するタブをクリックします。
- Create New Data Source ダイアログボックスが表示されます。Select a driver for which you want to set up a data source テーブルで PostgreSQL Unicode を選択します。
- Finish をクリックします。
- Data Source Name 編集ボックスで、このデータソースに割り当てる名前を入力します。
- Database 編集ボックスで、このデータソースからアクセスする仮想データベースの名前を入力します。
- Server 編集ボックスで、Teiid ランタイムのホスト名または IP アドレスを入力します。
注記
ファイアウォールまたは NAT アドレスを介して接続している場合は、ファイアウォールアドレスまたは NAT アドレスを入力する必要があります。 - Port 編集ボックスで、システムが ODBC リクエストをリッスンするポート番号を入力します (Red Hat JBoss Data Virtualization のデフォルトでは、ODBC リクエストをポート 35432 でリッスンします)。
- User Name および Password 編集ボックスで、Teiid ランタイムアクセスのユーザー名およびパスワードを入力します。
- SSL モードは無効 (disabled) のままにしておきます (現在、SSL 接続はサポートされていません)。
- データソースの詳細を Description フィールドに入力します。
- Datasource ボタンをクリックし、オプションを設定します。Parse Statements、Recognize Unique Indexes、Maximum、Text as LongVarChar、および Bool as Char にチェックマークを入れます。MaxVarChar を 255、Max LongVarChar を 8190、Cache Size を 100、SysTable Prefixes を dd_: に設定します。2 ページ目では、LF、Server side prepare、default、7.4+ をクリックします。 Extra Opts を 0x0 に設定します。
- Save をクリックします。Red Hat JBoss Data Virtualization が稼働している場合は、任意で Test をクリックすると接続を検証できます。
Excel や Access などのアプリケーションを使用して VDB でデータをクエリーできるようになりました。
表10.1 Red Hat JBoss Data Virtualization 用の主な ODBC 設定
| 名前 | 説明 |
|---|---|
| Updateable Cursor および Row Versioning | 使用不可。 |
| serverside prepare、Parse Statements および Disallow Premature の使用 | 「Use serverside prepare」を有効にし、「Parse Statements」/「Disallow Premature」を無効にすることを推奨します。 |
| SSL モード | 『セキュリティーガイド』を参照。 |
| Declare/Fetch カーソルおよび Fetch Max Count の使用 | 大規模な結果セットが使用される場合にリソースを効率よく管理するために使用する必要があります。 |
10.5.2. Red Hat Enterprise Linux での ODBC オプションの設定
手順10.6 Red Hat Enterprise Linux での ODBC オプションの設定
yum install unixODBCコマンドを実行し、ドライバーマネージャーをインストールします。odbcinst -q -dコマンドを実行し、PostGreSQLdriver が正しくインストールされたことを確認します。- DSN を作成するには、
sudo vi /opt/redhat/odbc.iniを実行して、テキストエディターで設定ファイルを開きます。注記
このファイルを開くには、sudo を使用するか root でログインしている必要があります。 - 以下の設定をファイルに追加します。
[<DSN name>] Driver = /usr/lib/psqlodbc.so Description = PostgreSQL Data Source Servername = <Teiid Host name or ip> Port = 35432 Protocol = 7.4 UserName = <user-name> Password = <password> Database = <vdb-name> ReadOnly = no ServerType = Postgres ConnSettings = UseServerSidePrepare=1 ByteaAsLongVarBinary=1 Optimizer=0 Ksqo=0 Trace = No TraceFile = /var/log/trace.log Debug = No DebugFile = /var/log/debug.log
- ファイルを保存して、テキストエディターを終了します。
- 以下のコマンドを実行して DSN をテストします。
isql <DSN-name> [<user-name> <password>] < commands.sql
注記
DSN を使用せずに接続するには、以下の DSN を使用しない接続文字列を使用します。ODBC;DRIVER={PostgreSQL};DATABASE=<vdb-name>;SERVER=<host-name>;PORT=<port>;Uid=<username>;Pwd=<password>注記
isql を実行した後にエラーが発生して「Can't open lib '/opt/redhat/jboss-dv/v6/psqlodbc/lib64/psqlodbc.so' : file not found」というメッセージが表示される場合、それは一部の postgres ライブラリーがないことを意味します。この問題を解決するには、root でyum install postgresコマンドを実行します。パッケージがインストールされていることを確認するには、rpm -qa|grep postコマンドを実行します。postgresql と postgresql-jdbc パッケージが一覧表示されるはずです。
10.6. DSN を使用しない接続
ODBC;DRIVER={PostgreSQL Unicode};DATABASE=<vdb-name>;SERVER=<host-name>;PORT=<port>;Uid=<username>;Pwd=<password>;c4=0;c8=1; ODBC;DRIVER={PostgreSQL};DATABASE=<vdb-name>;SERVER=<host-name>;PORT=<port>;Uid=<username>;Pwd=<password>;c4=0;c8=1;
第11章 自動インストール
11.1. 自動インストール
- https://access.redhat.com/jbossnetwork/ から関連するインストーラー JAR ファイルをダウンロードしておく必要があります。
- インストーラー (グラフィカルまたはテキストモード) を使用してインストールを行ったときにスクリプトを生成し、XML ファイルとして保存しておく必要があります。
手順11.1 スクリプトを用いたインストール
java -jar jboss-PRODUCT-installer-VERSION.jar SCRIPT.xml
製品が正常にインストールされ、スクリプトの指定どおりに設定されます。
第12章 クラウド環境での実行
12.1. Amazon AWS Cloud インスタンスでの Red Hat JBoss Data Virtualization の実行
手順12.1 Amazon AWS Cloud インスタンスでの Red Hat JBoss Data Virtualization の実行
- セキュリティーグループを更新し、ポートを開きます (最低でも TCP、HTTP、および SSH ポートを開く必要があります)。
- サーバーを起動するには、パラメーター
-Djboss.bind.address.management=0.0.0.0および-b 0.0.0.0 example ./standalone.sh -Djboss.bind.address.management=0.0.0.0 -b 0.0.0.0を追加して、管理およびホストポートをバインドします。 - Teiid Designer から AWS インスタンスにアクセスするには、JDBS の設定に移動し、General, Network Connections SSH2 を選択します。次に、Key Management タブの Load Existing Key を使用して Amazon によって生成されたキーを追加します。
- サーバー接続を作成するには、Server Configuration Overview Panel の Server Behavior で Remote System Deployment を選択します。必ず Server is externally managed... にもチェックマークを入れるようにしてください。New Host ボタンをクリックし、SSH Only オプションを選択した後、Next をクリックします。Amazon パブリック IP アドレスと一致するようホスト名を設定し、接続名が同じになるようにします。Finish をクリックします。
- Remote Systems タブを開きます。新しい接続を右クリックし、connect をクリックします。ユーザー ID を入力します (SSH キーが設定されている場合はパスワードを入力する必要はありません)。
- Server Configuration Overview Panel に戻り、ホストのドロップダウンメニューに新たに作成したホストが選択されていることを確認します。
- サーバーを起動します (起動したサーバーの状態を切り替えます)。
12.2. Google Compute インスタンスでの Red Hat JBoss Data Virtualization の実行
手順12.2 Google Compute インスタンスでの Red Hat JBoss Data Virtualization の実行
- Google Developers Console - Compute - Compute Engine - VM Instance - [インスタンスの名前] - Network と選択し、必要なポートを開きます。
- Google Developers Console - Compute - Compute Engine - VM Instance - [インスタンスの名前] - SSH KEys と選択し、パブリック SSH キーをアップロードします。
- 管理ポート (jboss.bind.address.management) を外部インターフェースへバインドします (管理ポートのデフォルト値は
localhostです)。
12.3. Red Hat JBoss Data Virtualization の Azure インスタンスへの接続
手順12.3 Azure への接続
- Azure データベースの JDBC 接続文字列を取得します。Azure 管理ポータルでデータベースをクリックしてから「Connect to your database」セクションを見つけます。
- 「View SQL Database connection strings...」リンクをクリックします。必要な JDBC 文字列が提供されます。
- このクラウドデータベースでは、これにアクセスするマシンの IP アドレスをファイアウォールルールに登録する必要があります。Azure データベースダッシュボードで、「Manage allowed IP addresses」をクリックしてから、お使いのサーバーの IP アドレスを追加します。これは DV インスタンスがローカルサーバーに置かれている場合には簡単な手順になります。
- DV インスタンスが OpenShift にデプロイされている場合は OpenShift インスタンスに ssh を実行します。コマンドラインに ping $OPENSHIFT_GEAR_DNS と入力します。ping 応答の最初の行は以下のようになります。
PING ec2-54-221-126-53.compute-1.amazonaws.com (10.181.128.66) 56(84) bytes of data.
ec2 名からサーバーの IP を推測することができます。ec2-54-221-126-53 --> ( 54.221.126.53 )派生した IP アドレスをcloud db firewall rule (クラウドデータベースファイアウォールルール) に登録します。 - JBoss Data Virtualization はモデル駆動型アプローチを導入しています。最初に、ソースとソースの構造をインポートしてソースモデルを作成します。Teiid Designer で Teiid Designer perspective を開きます。次に「File」 - 「New」 - 「Teiid Model Project」を選択して新規の「Model Project」を作成します。最初のウィザードページでプロジェクト名として「MyProject」と入力し、「Finish」をクリックします。これでプロジェクトが作成されます。
- Model Explorer で「MyProject」をクリックしてから「Import...」 - 「JDBC Database」 - 「Source Model」を右クリックします。「Next」をクリックします。
- 「Import Database via JDBC」ウィザードで、「New...」ボタンをクリックして新規の Connection Profile (接続プロファイル) を作成します。タイプとして「Generic JDBC」を選択し、名前として「AzureCP」を入力します。「Next」をクリックします。
- 「Drivers」コンボボックスの横にある「New Driver Definition」アイコンを選択して新規ドライバーを作成します。「Generic JDBC Driver template」を選択してから名前に「AzureDriver」を入力します。
- 「JAR List」タブで「Add JAR/Zip... 」ボタンをクリックしてから、ファイルシステムにダウンロードしている SQL Server type 4 driver jar を選択します。「OK」をクリックして「Driver Definition」(ドライバーの定義) の作成を終了します。
- 接続については、cloud db 接続文字列で指定される実際のデータベース名などを使用した一般的なプロパティーを入力します。
- 接続文字列から「Optional」(オプション) プロパティーを入力します。
- 「Test Connection」ボタンをクリックして接続が正常であることを確認します。「Finish」をクリックします。
- 「JDBC import」ウィザードで操作を継続し、インポートする必要のあるテーブルなどを選択します。ソースモデル (AzureSourceModel など) の名前を選択します。インポートウィザードの完了時に、ソースモデルがモデルプロジェクト内に作成されます。
手順12.4 データのプレビュー
- Designer でサーバーが実行中であることを確認します。
- テーブルを選択し、次にツールバーの「running man」アイコンをクリックします。これにより、クラウドデータベーステーブルの内容が表示されます。
- 作成したばかりのソースモデルを使ってさらに複雑な変換を作成することもできます。任意の方法でソースの変換と結合を実行するための追加のビューを作成できます。
第13章 OpenShift で Red Hat JBoss Data Virtualization Cartridge を実行
13.1. カートリッジのインストール
- OpenShift ユーザーアカウントを作成します。
- OpenShift Web コンソールを起動し、https://openshift.redhat.com/app/console/applications の Applications ページに移動します。
- Application タブへ移動し、Add Application... を選択します。
- xPaaS セクションへ移動し、JBoss Data Virtualization cartridge を選択します。
- アプリケーションの名前 (例: jbossdv) を入力します。
- アカウントが許可する場合は Medium Gear を選択します。
- Create Application ボタンをクリックします。
- Red Hat JBoss Data Virtualization Cartridge がデプロイされます。
重要
今後使用するときのために、ユーザー名とパスワードの情報をコピーし、安全な場所に保管しておいてください。 - Continue to the application overview page をクリックし、Data Virtualization カートリッジの概要を確認します。状態が Started であることを確認します。
- アプリケーションリンクをクリックすると、Data Virtualization の Welcome ページが表示されます。このページにはカートリッジ情報や役立つリンクが含まれています。
- カートリッジがデプロイされた後に、http://[MYAPP]-[MYDOMAIN].rhcloud.com へ移動し、状態を確認します。ユーザー、OData、および REST ロールとともにユーザーが自動的に生成されます。
- http://[MYAPP]-[MYDOMAIN].rhcloud.com/modeshape-webdav および http://[MYAPP]-[MYDOMAIN].rhcloud.com/modeshape-rest の ModeShape へアクセスします。msuser と msadmin の 2 人の ModeShape ユーザーがインストールとともに生成されます。
- http://[MYAPP]-[MYDOMAIN].rhcloud.com/dashboard の Dashboard Builder へアクセスします。Dashboard 管理者である dbadmin がインストールとともに生成されます (Teiid ユーザーは Dashboard の読み取り専用アクセスのみ許可されます)。
重要
13.2. OpenShift でデータ仮想化 Web インターフェースを使用
手順13.1 Box Grinder プラグインのインストール
- 最初に、MySQL データベースを OpenShift Data Virtualization インスタンスに割り当てます。ご使用のデータ仮想化アプリケーションの概要ページに移動し、Add MySQL 5.5 リンクをクリックします (Databases セクションの下にあります)。MySQL カートリッジがデプロイされます。完了すると、正常にデプロイされたことを伝える画面が表示されます。
重要
後で参照できるよう、必ずクレデンシャルの情報を保存してください。 - Tools and Support の下にある Add phpMyAdmin 4.0 リンクをクリックします。これにより、Web インターフェースが追加され、MySQL データベースの管理が容易になります。これで、MySQL データベースと管理インターフェースのデプロイメントが完了します。
- phpMyAdmin インターフェースを使用して、一部のデータをデータベースにロードします。https://myApp-myDomain.rhcloud.com/phpmyadmin で phpMyAdmin カートリッジをインストールしたときに表示されたリンクを使用します。カートリッジがインストールされたときに取得した root ユーザーと root パスワードを使用します。左側のツリーパネルで、DV アプリケーション (例: jbossdv1) の名前と一致するデータベースをクリックします。SQL タブを選択します。SQL タブ上でこの DDL をコピーし、テキストエリアに張り付けます。
CREATE TABLE PricesTable ( ProdCode CHAR(40) NOT NULL, SalePrice DECIMAL, PRIMARY KEY (ProdCode) ); INSERT INTO PricesTable VALUES ('GC1020', 3499.0), ('GC1040', 19990.0), ('GC1060', 75000.0), ('GC3020', 10200.0), ('GC3040', 38000.0), ('GC3060', 95000.0), ('GC5020', 28000.0), ('GC5040', 59900.0), ('GC5060', 110000.0), ('IN7020', 4000.0), ('IN7040', 16000.0), ('IN7060', 42000.0), ('IN7080', 69000.0), ('SL9020', 4999.0), ('SL9040', 9999.0), ('SL9060', 14999.0), ('SL9080', 19999.0);最後に、管理インターフェースの右端にある GO ボタンをクリックします。PricesTable テーブルが作成され、事前設定されます。内容をクリックするとその内容を確認できます。 - Data Virtualization カートリッジを再起動します。これは、MySQL データソースを初期化するために必要になります。アプリケーション概要ページの Restart application アイコンをクリックします。
- http://www.developerforce.com/events/regular/registration.php?d=70130000000EjHb へアクセスし、Salesforce アカウントを登録します (アカウントへログインするリンクが含まれる電子メールを受け取ります)。
- ユーザー名とパスワードを入力して Salesforce インターフェースへログインし、Personal Setup - Reset My Security Token へ移動します。セキュリティートークンをリセットします。セキュリティートークンが含まれる別のメールを受け取ります。
- 以下の例で Salesforce インスタンスへの接続を確立したら、Salesforce のユーザー名を使用します (パスワードは Salesforce パスワードとセキュリティートークンの組み合わせになります)。
- http://APP-NAME-DOMAIN-NAME.rhcloud.com/dv-ui の OpenShift にデプロイされた Web インターフェースに移動します (APP-NAME はアプリケーションに付けた名前に置き換え、DOMAIN-NAME は OpenShift ドメイン名に置き換えます)。
- Data Library 画面から Create Data Services リンクをクリックします。Create Data Service ページへ移動されます。
- Manage Sources ボタンをクリックします。Manage Data Sources ページへ移動されます。
- MySQLDS ソースをクリックします。これは設定されていますがアクティブでない状態です。ソースの mysql5 トランスレーターを選択し、Save Changes ボタンをクリックします。デプロイされると、ソースはアクティブになるはずです (緑色のチェックマークが表示されます)。
- Add Source ボタンをクリックします。MyNewSource というデフォルトの H2 ソースが作成されます。
- MyNewSource をクリックします。表示されたプロパティーで Source Type の Name に SalesforceDS を入力し、Salesforce ボタンをクリックします。Ok ボタンをクリックすると、ソースが Salesforce タイプに変更され、トランスレーターが Salesforce に設定されます。Connection Properties で Salesforce アカウントのユーザー名を入力します。パスワードとトークンの組み合わせをパスワードとして入力します。
- Save Changes ボタンをクリックします。各ダイアログボックスに対して Ok をクリックします。Salesforce ソースがデプロイされます (終了するまで数分かかります)。
- バックリンクをクリックし、Create Data Service ページに戻ります。
- 次に、MySQL データベーステーブルにアクセスするデータサービスを作成します。サービス名に対して MySQLService を入力します。サービスの説明を入力します。
- Service Helpers Active Sources タブの MySQLDS をクリックします。
- Tables で dv61.PricesTable をクリックし、チェックボックスを使って両方の列を選択します。
- Service View Definition を作成するには Create Service View ボタンをクリックします。Service View Definition テキストエリアが事前設定されます。
- Test Service ボタンをクリックしてサービスをテストします。
- Create Data Service をクリックします。エントリーが許可され、サービスが作成されます。Data Service Details ページへリダイレクトされます。
- Salesforce 専用サービスの作成手順も同様になります。Data Library へ戻り、Create Data Service ボタンをクリックして新しいサービスを作成します。
- サービス名に SalesforceProductService を入力します。サービスの説明を入力します。
- Service Helpers Active Sources タブで SalesforceDS をクリックします。
- Tables で Product2 をクリックし、チェックボックスを使って Name および ProductCode 列を選択します。
- Service View Definition を作成するには Create Service View ボタンをクリックします。Service View Definition テキストエリアが事前設定されます。
- 前回と同様にサービスをテストしてサンプルデータを確認し、Create Service をクリックしてサービスを作成します。
- マッシュアップサービスの作成手順も同様になります。Data Library へ戻り、Create Data Service ボタンをクリックして新しいサービスを作成します。
- サービス名に MashupService を入力します。サービスの説明を入力します。
- Service Helpers セクションで Join Definition タブをクリックします (ここで結合を定義します)。
- Available Sources ドロップダウンメニューで MySQLDS を選択します。Source Tables で PricesTable をクリックします。左側のボタンをクリックし、Left (左) テーブルとして指定します。
- Available Sources ドロップダウンメニューで SalesforceDS を選択します。Source Tables で Product2 テーブルをクリックします。右側のボタンをクリックし、Right (右) テーブルとして指定します。
- 左側の Prices テーブルで ProdCode と SalesPrice 列を確認します。右側の Product2 テーブルで Name 列をチェックします。
- JoinType は Inner Join のままにしておきます。
- 左側の Join Criteria 列で ProdCode を選択します。
- 右側の Join Criteria 列で ProductCode を選択します。
- Apply ボタンをクリックし、Service Definition DDL を生成します。
- Test Service ボタンをクリックしてサンプルデータを確認します。
- Create Service ボタンをクリックし、マッシュアップサービスを作成します。Data Service Details ページへリダイレクトされます。Data Service Details ページにはデータのサンプルが表示され、異なる接続オプションの接続手順と URL も提供されます。
- Back to Library リンクをクリックし、Data Library に戻ります。作成した 3 つのサービスが Data Library ページに表示されます。
注記
各サービスに使用できるアクションは他にもあります。- サービスの編集: Edit Data Service ページへリダイレクトします。
- サービスの複製: 選択したサービスのコピーを作成します。
- サービスのテスト: Data Service Details ページへリダイレクトします。
- サービスの削除: 選択したサービスを削除します。
- ファイルへの保存: サービスは Teiid の「動的 VDB」によってサポートされます。このアクションによって動的な VDB xml がファイルへ保存されます。
付録A 事前に必要なコンポーネントのインストール
A.1. Red Hat Enterprise Linux に OpenJDK をインストール
手順A.1 Red Hat Enterprise Linux に OpenJDK をインストール
ベースチャンネルのサブスクライブ
RHN ベースチャンネルから OpenJDK を取得します (Red Hat Enterprise Linux のインストールはデフォルトでこのチャンネルにサブスクライブされています)。パッケージのインストール
yum ユーティリティを使用して OpenJDK をインストールします:yum install java-1.7.0-openjdk-develOpenJDK がシステムデフォルトであることを確認
以下の手順に従って、正しい JDK がシステムデフォルトとして設定されていることを確認します。- root で
javaの alternatives コマンドを実行します。/usr/sbin/alternatives --config java
/usr/lib/jvm/jre-1.7.0-openjdk/bin/javaを選択します。- 同様に、
javacの alternative コマンドを実行します。/usr/sbin/alternatives --config javac
/usr/lib/jvm/java-1.7.0-openjdk/bin/javacを選択します。
付録B 設定情報
B.1. サポートされるデータソースおよびトランスレーター
表B.1 サポートされるデータソースおよびトランスレーター
| データソース | ドライバー | トランスレーター |
|---|---|---|
|
Actian Analytics Express 2.0
|
2.0
|
actian-vector
|
|
Amazon Redshift
|
postgresql 9.2
|
redshift
|
|
Apache Accumulo 1.5.0
|
該当なし
|
accumulo
|
|
Apache Cassandra 2.2.4
|
該当なし
|
cassandra
|
|
Apache Hive 2.0.0
|
2.0.0
|
hive
|
|
Apache Solr 4.9.0
|
該当なし
|
solr
|
|
Apache Spark 1.6.0
|
Hive 1.2.1
|
hive
|
|
Cloudera Hadoop 5.5.1
|
5.5.1
|
impala
|
|
EDS 5.x
|
現行の Teiid Driver
|
teiid
|
|
ファイル – 区切り、固定長
|
該当なし
|
file
|
|
汎用データソース -JDBC ansi
|
該当なし
|
jdbc-ansi
|
|
汎用データソース-JDBC simple (postgresql84)
|
postgresql 8.4
|
jdbc-simple
|
|
Greenplum 4.x
|
postgresql 9.0
|
greenplum
|
|
HBase 1.1
|
phoenix 4.5.1 HBase 1.1
|
hbase
|
|
Hortonworks Hadoop
|
2.3.4
|
hive
|
|
IBM DB2 10
|
4.12.55
|
db2
|
|
IBM DB2 9.7
|
4.12.55
|
db2
|
|
Informix 12.10
|
4.10.JC5DE
|
informix
|
|
Ingres 10
|
4.1.4
|
ingres
|
|
JBoss Data Grid 6.4 (ライブラリーモード)
|
該当なし
|
infinispan-cache
|
|
JBoss Data Grid 6.4 (リモートクライアント- hotrod)
|
該当なし
|
infinispan-cache-dsl
|
|
LDAP/ActiveDirectory v3
|
該当なし
|
ldap
|
|
MariaDB
|
mysql 5.1.22
|
mysql5
|
|
ModeShape/JCR 3.1
|
3.8.4
|
modeshape
|
|
MongoDB 3.0
|
該当なし
|
mongodb
|
|
MS Access 2013
|
該当なし
|
アクセス
|
|
MS Excel 2010
|
該当なし
|
excel
|
|
MS Excel 2013
|
該当なし
|
excel
|
|
MS SQL Server 2008
|
4.0.2206.100
|
sqlserver
|
|
MS SQL Server 2012
|
4.0.2206.100
|
sqlserver
|
|
MySQL 5.1
|
mysql 5.1.22
|
mysql5
|
|
MySQL 5.5
|
mysql 5.1.22
|
mysql5
|
|
Netezza 7.2.x
|
7.2.1.1
|
netezza
|
|
Oracle 11g RAC
|
12.1.0.2.0
|
oracle
|
|
Oracle 12c
|
12.1.0.2.0
|
oracle
|
|
PostgreSQL 8.4
|
postgresql 8.4
|
postgresql
|
|
PostgreSQL 9.2
|
postgresql 9.2
|
postgresql
|
|
HTTP 上の REST/JSON
|
該当なし
|
ws
|
|
RHDS 9.0
|
該当なし
|
ldap
|
|
Salesforce.com API 22.0
|
NA
|
salesforce
|
|
Salesforce.com API 34.0
|
NA
|
salesforce-34
|
|
SAP_Hana 1.00.102.01.1444147999
|
1.00.82.00_0394270-1510
|
hana
|
|
SAP Netweaver Gateway
|
odata 4
|
sap-nw-gateway
|
|
Sybase ASE 15
|
jconn4-26502
|
sybase
|
|
Sybase IQ 16 Express
|
jconn4-v7
|
sybaseIQ
|
|
Teradata Express 15
|
15.10.00.05
|
teradata
|
|
Vertica 7.2.1
|
7.2.1-0
|
vertica
|
|
Webservices
|
該当なし
|
ws
|
|
XML ファイル
|
該当なし
|
FILE
|
注記
注記
付録C 改訂履歴
| 改訂履歴 | |||
|---|---|---|---|
| 改訂 6.30-10.1 | Mon Jan 23 2017 | Terry Chuang | |
| |||
| 改訂 6.30-10 | Wed Oct 26 2016 | David Le Sage | |
| |||
| 改訂 6.2.0-032 | Thu Dec 10 2015 | David Le Sage | |
| |||