intra-mart e Builder for Accel Platform / セットアップガイド 第８版 2015-08-01

intra-mart e Builder for Accel Platform / セットアップガイド 第８版 2015-08-01

目次 ≪  ライセンス登録 e Builder のアップデート  ≫

デバッグサーバの構築

概要

  • 本項では、デバッグサーバの構築方法について説明します。
    デバッグサーバとは、e Builder から起動可能な「intra-mart Accel Platform」専用の開発環境用サーバです。

    コラム

    デバッグサーバ機能には以下の注意事項、及び利用制限があります。
    1. デバッグサーバライセンスは開発用途でご利用ください。運用用途にはご利用できません。
    2. デバッグサーバとして利用できるWebアプリケーションサーバは Resin 4.0 のみです。
    3. 「intra-mart Accel Platform」を購入している場合、「intra-mart Accel Platform」に同梱されている Resin Pro をご利用できます。
    4. サーバ構成はスタンドアローン構成のみです。分散構成は構築できません。
    5. intra-mart Accel Applications およびその他の Extensions 製品の開発環境での利用については別途ライセンスが必要になります。

構築手順

  • セットアップ手順は intra-mart Accel Platform の設定手順と同様になります。
    ここでは、開発環境用のWebアプリケーションサーバのResinをローカル環境にセットアップし、テナント環境の構築まで行う手順について説明します。
    1. データベースのセットアップ
    2. war ファイルの作成 (intra-mart Accel Platform 構成ファイルの作成)
    3. Apache Cassandra の設定 (IMBox を利用する場合)
    4. Resin (Windows版) のセットアップ
    5. デバッグサーバ を e Builder に登録
    6. Apache Cassandra の起動 (IMBox を利用する場合)
    7. デバッグサーバの起動
    8. warファイルのデプロイ
    9. デバッグサーバのテナント環境の構築

データベースのセットアップ

開発用に使用するデータベースをセットアップしてください。
セットアップの方法は、「 intra-mart Accel Platform セットアップガイド」の 「Database のインストールと設定」を参照してください。

コラム


プログラム開発プロジェクトに関わる開発者が複数名いる場合は、同一のデータベースを利用することはできても、同一スキーマでは開発することはできません。
必ず開発者毎、環境毎にスキーマを分けてください。

war ファイルの作成 (intra-mart Accel Platform 構成ファイルの作成)

開発環境用に利用する warファイルを作成してください。
war ファイルの作成方法に関しては「 intra-mart Accel Platform セットアップガイド」の「intra-mart Accel Platform 構成ファイルの作成」を参照してください。
また、開発環境用に war ファイルを作成する際には以下を参考にしてください。
  • スクリプト開発においてデバッグ機能を利用したい場合は、アプリケーションで「モジュール開発支援ライブラリ」を追加し、「デバッガ」を選択してください。
    (下記イメージはモジュール開発支援ライブラリの8.0.1を設定した場合です)
    im-juggling 画面

  • SAStruts+S2JDBC開発においてSeasar2のHOT deploy機能を利用したい場合は、Jugglingビルドウィザードの実行環境で「結合テスト環境」を選択してください。
    「結合テスト環境」を選択した場合、intra-mart Accel Platform 2013 Summerでは下記設定で出力されます。
    • env.txt : ct
    • s2container.dicon : hotdeploy.dicon を include

    コラム

    Jugglingビルドウィザードの実行環境の各選択値に対して、env.txtは以下のように出力され、標準のs2container.diconではそれぞれ下記のようにdeployモードが有効になります。
    • [単体テスト環境] : ut → WARM deploy
    • [結合テスト環境] : ct → HOT deploy
    • [統合テスト環境] : it → COOL deploy
    • [運用環境] : product → COOL deploy
  • intra-mart WebPlatform Ver.7.2 に同梱されていた im_eb_component.jar を利用していた場合、「ライブラリ」にチェックを入れてください。
    また、モジュール開発支援ライブラリを設定する際、一部のモジュールには必須となるベースモジュールがあります。
    その設定が欠落していた場合は im-Juggling 上でエラーメッセージを表示し、そのベースモジュールが必要となるかを表示します。
    この指示に従い、ベースモジュールを設定してください。
    (下記イメージはモジュール開発支援ライブラリの8.0.1を設定した場合です)
    im-juggling 画面

コラム

プログラム開発プロジェクトに関わる開発者が複数名いる場合は、開発環境の構成を統一するために、作成したwarファイルを共有するとよいです。

Apache Cassandra のセットアップ (IMBox を利用する場合)

intra-mart Accel Platform の構成にIMBoxを含めている場合、ローカル環境に Apache Cassandra をセットアップしてください。
セットアップの方法は、「 intra-mart Accel Platform セットアップガイド」の 「Apache Cassandra （ IMBox を利用する場合）」を参照してください。

コラム

プログラム開発プロジェクトに関わる開発者が複数名いる場合は、必ず開発者毎、環境毎にApache Cassandraをセットアップしてください。

Resin (Windows版) のセットアップ

ローカル環境に Resin (Windows版) をセットアップしてください。
セットアップの方法は、「 intra-mart Accel Platform セットアップガイド」の 「Resin （Windows版）のインストール」を参照してください。

コラム

Resin (Windows版) は、intra-mart Accel Platform に同梱されています。
Try版としてご利用の場合は、以下よりResinをダウンロードしてください。
* Caucho Resin 4.0.35.zip

e Builder にデバッグサーバを登録

e Builder を起動し、開発環境用の デバッグサーバ を e Builder に登録してください。

注意

e Builder 2012 Winter から e Builder 2013 Spring以降にアップデートした場合、
Resinサーバの設定を削除し、デバッグサーバを登録・利用するようにしてください。
  • eclipse のツール・バーから「ウィンドウ」→「ビュー」で「サーバー」を選択し、表示します。
ツール・バー メニュー
  • 「サーバー」ビューから「新規サーバ・ウィザード」を表示します。
初期ウィザード画面

コラム

上記イメージは、サーバーが何も設定されていない状態のイメージです。
あらかじめ別のサーバを設定している方は、ビューから右クリックで「新規」を選択してください。
  • 「新規サーバ・ウィザード」から「intra-mart」→「Debug Server(Resin4.0)」を選択します。

  • サーバを起動する場合、JavaはJDKを利用するように設定してください。

  • サーバ名の設定は、英数字のみを利用するようにしてください。

サーバ・ウィザード画面
  • Resin HomeにResinサーバのインストールディレクトリを指定します。
    Cassandraを使用する場合はCassandra HomeにCassandraのインストールディレクトリを指定し、次へボタンを押下します。
Resinのディレクトリの選択
  • 既にモジュールプロジェクトがある場合、デバッグサーバとの関連付けを行います。
    モジュールプロジェクトがない場合はそのまま終了ボタンを押下します。
モジュールプロジェクトの関連付け
  • 「終了」ボタンを押下すると「サーバー」ビュー上に設定した デバッグサーバ の情報が表示されます。
Resin 設定後のビュー
  • 「サーバー」ビューでDebug Serverの概要を開きます。
    必要に応じて以下の設定を変更してください。

  • 一般情報

  • サーバ名：このサーバ設定の名前を設定します。
  • ホスト名：サーバ起動時に利用するホスト名を指名します
  • ランタイム：この設定の実行時に起動させるサーバを設定します。
  • 構成パス：このサーバを起動する際の構成を設定します。
  • 起動構成を開く：起動構成に関する細かい設定を行います。具体的にはサーバ実行時のVM引数や、実行時に設定するクラスパスなどを設定することができます。
  • サーバのプロパティ
  • HTTP Port - デバッグサーバのHTTPポートを設定します。
  • JavaScript Debug Port - スクリプト開発モデル用のデバッグポートを設定します。
  • サーバの起動オプション
  • JavaEE デバッグ - デバッグ起動時Javaソースのブレークポイントを使用可能にします。
  • JavaScript デバッグ - デバッグ起動時ファンクションコンテナのブレークポイントを使用可能にします。
  • Cassandra サーバ - デバッグサーバ起動時にCassandraサーバを起動します。
サーバの起動構成

コラム

サーバ実行時メモリ領域やヒープ領域の設定は、「起動構成を開く」の「引数」タブで設定された情報が最優先となります。
引数の設定は、上記の「引数」タブのVM引数のテキストエリア内で記述されています。
初期値は以下の用に設定されていますが、OutOfMemoryが発生する場合は以下の値を変更して調整を行なってください。

初期値： -Xss1m -Xmx512m -XX:MaxPermSize=256m -server

デバッグサーバの起動

「サーバー」ビューで、「サーバーを実行」ボタンを押下すると、デバッグサーバが起動します。
サーバの起動

コラム

デバッグサーバの起動に利用するJREは、デバッグサーバの設定画面の[一般情報]-[ランタイム]より設定することができます。
デバッグサーバの起動に利用するJREは必ず、JRE7またはJDK7を設定してください。

コラム

IMBox を利用する場合、Apache Cassandra も起動してください。
デバッグサーバのサーバ起動オプションで「Cassandra サーバー」にチェックすることで、デバッグサーバ起動時にApache Cassandraが停止している場合は起動します。

注意

e Builderのライセンスが失効している場合、デバッグサーバの起動ができません。
e Builderのライセンスについては「ライセンス登録」を参照してください。

warファイルのデプロイ

  1. 作成したwarファイルを任意のディレクトリに配置します。

  2. コマンドプロパティを起動し、以下のコマンドを実行してください。

    # cd <%RESIN_HOME%>
# resin deploy 任意のディレクトリパス/warファイル名

注意

warファイルのデプロイには、デバッグサーバが起動している必要があります。

注意

Jugglingで作成したAccel Platform 構成ファイル(warファイル)を複数デプロイして開発することはできません。
複数デプロイしてデバッグサーバを起動した場合、デバッグサーバライセンスやスクリプトデバッグ等のデバッグサーバ機能が正常に動作しません。

コラム

warファイルのアンデプロイについては「 intra-mart Accel Platform セットアップガイド」の「起動・停止、デプロイ・アンデプロイ(Windows版)」を参考にしてください。

デバッグサーバのテナント環境の構築

デバッグサーバの起動後、テナント環境の構築を行ってください。
構築の方法は、「intra-mart Accel Platform セットアップガイド」の「テナント環境の構築」を参照してください。

注意

デバッグサーバ環境におけるライセンスの登録では、intra-mart Accel Platformのライセンスキーを登録する必要はございません。
デバッグサーバライセンスとして、「intra-mart Accel Platform アドバンスト」と同等のライセンスとして、アプリケーションの開発を目的に、Accel Platformのすべての機能を利用できます。
ただし、デバッグサーバ環境で intra-mart Accel Applications を利用する場合はその製品毎のライセンスを登録する必要があります。

参考

[参考] デバッグサーバの起動・停止

「サーバー」ビューで、「サーバーを実行」ボタンを押下すると、デバッグサーバが起動します。
サーバの起動
「サーバー」ビューで、「サーバーを停止」ボタンを押下すると、デバッグサーバが停止します。
サーバの停止

注意

e Builderのライセンスが失効している場合、デバッグサーバの起動ができません。
e Builderのライセンスについては「ライセンス登録」を参照してください。

[参考] Cassandraサーバの実行・停止

  • デバッグサーバのサーバ起動オプションで「Cassandra サーバ」にチェックしているとき、
    Cassandra サーバはデバッグサーバ起動時に同期的に起動します。
    起動時のログは「コンソール」ビューから「選択されたコンソールの表示」→「Running cassandra process」を選択し、
    コンソールを切り替えることで確認できます。
    Cassandra サーバをコンソールに表示
  • Cassandraサーバを停止するときは同様に
    「選択されたコンソールの表示」→「Running cassandra process」を選択して
    コンソールをCassandraサーバに切り替えた上で「終了」ボタンを押下します。
    Cassandra サーバを停止

目次 ≪  ライセンス登録 e Builder のアップデート  ≫

Copyright © 2013 NTT DATA INTRAMART CORPORATION

⇄ Sidebar ↑Top