3.IM-Jugglingによるwarの作成¶
注意
この章は、移行するために必要な IM-Juggling プロジェクトの作成からWARファイルの作成までの方法の最低限必要な説明のみをしています。移行先の機能で提供されている設定(設定ファイル等)については、セットアップする Accelシリーズの各「セットアップガイド」、および、「設定ファイルリファレンス」を参照してください。注意
移行前に利用していたユーザアプリケーション(独自のプログラム等)も移行する場合は、 intra-mart Accel Platform上で動作するための作業が必要です。詳細は、 「ユーザモジュールへの対応」 を参照してください。また上記対応後は、ユーザモジュールとして IM-Juggling プロジェクトに組み込み、WARファイルを作成します。この方法については、「 intra-mart e Builder for Accel Platform アプリケーション開発ガイド / immファイルのエクスポート 」 、および、 「 作成したユーザモジュールを組み込む方法 」を参照してください。
IM-Jugglingを起動し、Juggling プロジェクトを作成します。
ベースモジュールより、移行後のエディションを選択します。
アプリケーションより、移行ツールを選択します。
注意
移行作業には、 移行ツール モジュールが必要です。必ず選択してください。互換機能を利用する場合、アプリケーションより、互換モジュールを選択します。
注意
移行前に利用していたユーザアプリケーション(独自のプログラム等)も移行する場合は、移行先で廃止されたAPIおよびタグを利用するための 互換機能 モジュールが必要です。必要有無については、「 互換対応表 」を参照してください。テナントデータベースの接続設定を行います。
intra-mart Accel Platformのテナントデータベースへのデータソース設定を、利用 AP サーバに応じた方法で行ってください。
例) Resinの場合、<resin-web.xml> を編集します。データソースマッピング設定を行います。
<conf/data-source-mapping-config.xml> を編集し、テナントデータベースのテナントID (/<data-source-mapping-config>/<tenant-data-source>/<tenant-id>) に対し、intra-mart WebPlatformから移行するログイングループIDを設定します。
<data-source-mapping-config> <tenant-data-source> <tenant-id>group1</tenant-id> <!-- ← 移行するログイングループIDを設定 -->Storageディレクトリの設定を行います。
アプリケーションのモジュール構成より、移行対象機能の移行モジュールを選択します。
アクセスセキュリティ移行モジュールと、IM-共通マスタ移行モジュールは必須です
基本的に、 移行元でインストールされている機能/アプリケーションの移行モジュールは必ず選択してください。
注意
例外として、intra-mart Accel Platformにおいてその機能をインストールしない (ベースモジュールで選択しない) 場合は、移行モジュールは選択しないでください。以下に例を示します。
intra-mart WebPlatformでインストールしていた機能を、intra-mart Accel Platformでもインストールする場合 → 移行モジュールを選択します。
データ移行が不要な場合でも、移行モジュールは選択してください。
intra-mart WebPlatformでインストールしていた機能を、intra-mart Accel Platformではインストールしない場合 → 移行モジュールは選択しません。
ポータルや、ViewCreator をインストールしない場合は、それぞれの移行モジュールは選択しないでください。
intra-mart WebPlatformでインストールしていない機能を、intra-mart Accel Platformではインストールする場合 → 移行モジュールは選択しません。
スタンダード→アドバンストのエディションアップなど、IM-Workflowをintra-mart Accel Platformから使い始める場合は、IM-Workflow移行モジュールは選択しないでください。
ログイングループIDの設定を行います。
<conf/system-constants-config.xml> を編集し、ログイングループIDを設定してください。
<system-constants-config> <system-constant key="tenant-id">default</system-constant> <!-- ← 移行するログイングループIDを設定 -->移行元の intra-mart WebPlatform のロケールに合わせて、intra-mart Accel Platformのシステムで利用可能なロケールを設定します。
国際化機能モジュールの任意設定ファイル 「ロケールマスタ(locale-config/im-locale-default.xml)」を出力します。
intra-mart WebPlatform で利用していたロケールと同じロケールを使用するように intra-mart Accel Platform 側のロケールを設定します。移行元の intra-mart WebPlatform にインストールされていないロケールを、コメントアウト、または削除してください。コラム
ロケールの設定についての詳細は、「Locale」を参照してください。利用機能における設定ファイル類を移行します。
ドキュメントワークフロー(BPW)
以下を intra-mart WebPlatformから IM-Juggling プロジェクトに移動してください。
bpw.ini{Resource Serviceサーバルート}/pages/platform/src/bpw/bpw.ini↓↓↓↓↓↓{ IM-Juggling プロジェクト}/conf/bpw/bpw.ini BPWCore.properties{Application Runtimeサーバルート}/doc/imart/WEB-INF/classes/jp/co/intra_mart/foundation/bpw/config/BPWCore.properties↓↓↓↓↓↓{ IM-Juggling プロジェクト}/conf/bpw/BPWCore.propertiesIM-ContentsSearch
マニュアルに従い、改めて設定を行ってください。
Webサービス
intra-mart WebPlatform 7.2 で Webサービス の各設定ファイルを編集している場合は、以下の移行作業を行ってください。
Axis2設定(axis2.xml)
Webサービス認証・認可モジュールの任意設定ファイル「Axis2設定 (axis2.xml)」を出力してください。
intra-mart WebPlatform での設定を出力ファイルに移行してください。移行元/先タグのマッピングは下表を参照してください。
intra-mart WebPlatform の場合移行元ファイル:{ApplicationRuntime}/doc/imart/WEB-INF/conf/axis2.xmlルートタグ: axisconfig/parameter@name=“jp.co.intra_mart.foundation.web_service” intra-mart Accel Platform の場合移行先ファイル:{Juggling プロジェクト}/conf/axis2.xmlルートタグ: axisconfig/parameter@name=“jp.co.intra_mart.foundation.web_service”enablePlainTextPassword
enableAuthorization
showSoapFaultDetail
wsUserInfoArgumentName
enablePlainTextPassword
enableAuthorization
showSoapFaultDetail
wsUserInfoArgumentName
注意
※ intra-mart Accel Platform では下記クラスが提供されないため、移行内容に下記が含まれる場合は、コメントアウトした状態で移行してください。
- jp.co.intra_mart.foundation.web_service.auth.impl.WSAuthModule4BPMS
- jp.co.intra_mart.foundation.web_service.auth.impl.WSAuthModule4UDDI
SOAPClientオブジェクト用設定
Webサービス認証・認可クライアントモジュールの任意設定ファイル「SOAPClientオブジェクト用設定(soap-client-config.xml)」を出力してください。
intra-mart WebPlatform での設定を出力ファイルに移行してください。移行元/先タグのマッピングは下表を参照してください。
intra-mart WebPlatform の場合移行元ファイル:{ApplicationRuntime}/conf/imart.xmlルートタグ: intra-mart/platform/service/application/jssp intra-mart Accel Platform の場合移行先ファイル:{Juggling プロジェクト}/conf/soap-client-config.xmlルートタグ: soap-client-configsoap-client/mode
soap-client/work-dir
soap-client/javac-encoding
soap-client/javac-verbose
soap-client/javac-xmx
soap-client/wsdl/storage/import-location/suffixes/suffix
soap-client/wsdl/storage/import-location/sub-dirs/sub-dir
mode
work-dir
javac-encoding
javac-verbose
javac-xmx
wsdl/import-file-suffixes/suffix
wsdl/import-sub-dirs/sub-dir
ユーザモジュール を追加します。
ビルドウィザードより、war を作成します。
注意
「サンプル」は選択しないでください。
war を Web Application Server にデプロイします。
注意
intra-mart Accel Platform は、J2EE の仕様に則った手法としてWARファイルによるデプロイ作業を行います。このため、特有のファイルのみをデプロイ後の環境へ、上書きコピーする等といった作業は推奨しません。デプロイ後の環境へ直接上書きコピー等を行うと、WARファイル更新(パッチ適用やユーザモジュールの追加)時に損失してしまう等のリスクがあります。