— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

Copyright © 2013 NTT DATA INTRAMART CORPORATION↑Top1

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

目次
改訂情報
はじめに
本書の目的
前提条件
対象読者
用語解説
各種インストール・設定変更
intra-mart Accel Platform 構成ファイルの作成
WebLogicの設定
Java ヒープサイズの設定
Java VM引数の設定
com.sun.mail.javax.mail.jar の差し替え
JAXBプロバイダの設定
タイムゾーンの設定
JTAの設定データソースの設定
warファイルのデプロイ
テナント環境の構築
セットアップで困ったら・・・
アップデート・パッチの適用

2

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

改訂情報
変更年月日

変更内容

2013-04-01

初版2013-07-01

第2版

下記を追加・変更しました「Java VM引数の設定 」を追加
「タイムゾーンの設定」を追加「JAXBプロバイダの設定」を変更

2013-10-01

第3版

下記を追加・変更しました「Java ヒープサイズの設定」を追加「DB2の設定」を変更「Microsoft SQL Serverの設定」を変更「Oracleの設定 」を変更
「PostgreSQLの設定 」を変更

2014-01-01

第4版

下記を追加・変更しました
目次に「 アップデート・パッチの適用」へのリンクを追加

2016-12-01

第5版

下記を追加・変更しました「はじめに」に注意を追加
DB2に関する記述を削除

2017-04-01

第6版

下記を修正しました「Java ヒープサイズの設定」の説明を修正

2018-04-01

第7版

下記を追加しました「Oracleの設定 」にコラムを追加

2019-04-01

第8版

下記を追加しました「intra-mart Accel Platform 構成ファイルの作成」に Metro と OpenPortal WSRP の選択に関する注意事項を追加

2020-08-01

第9版

下記を変更しました「JAXBプロバイダの設定」のシステムプロパティの値を 2018 Winter(Urara) 以降において最適な値に修正

2022-06-01

第10版

下記を追加しました「はじめに」の用語解説に %ORACLE_HOME% の説明を追加「com.sun.mail.javax.mail.jar の差し替え」を追加

2022-12-01

第11版

下記を変更しました
Microsoft SQL Server に関する記述を削除

2023-04-01

第12版

下記を追加しました「Java VM引数の設定 」のコラムにカスタマーサクセスライセンスとプロキシ利用時に設定する JVM 引数を追加

3

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

はじめに
本書の目的
本書では Oracle WebLogic Server 12c R2(12.2.1) に intra-mart Accel Platform のセットアップを行う手順について説明します。

前提条件
リリースノートに記載されているシステム要件を満たしている必要があります。
詳細は「リリースノート 」を参照してください。

注意
TERASOLUNA Server Framework for Java (5.x) for Accel Platform を利用する場合に制限事項があります。
詳細はリリースノートの「制限事項」を参照してください。

対象読者
以下の利用者を対象としています。
Oracle WebLogic Server 12c R2(12.2.1) に intra-mart Accel Platform のセットアップを行われる方

用語解説
Oracle WebLogic Server 12c R2(12.2.1) のホームディレクトリを %WEBLOGIC_HOME% と略します。
%WEBLOGIC_HOME% が格納されているディレクトリを %ORACLE_HOME% と略します。
Apache HTTP Server をインストールしたディレクトリを %APACHE_HOME% と略します。
Storage として使用するディレクトリを %STORAGE_PATH% と略します。
Webサーバ利用時の静的コンテンツを配置するディレクトリを %WEB_PATH% と略します。

4

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

各種インストール・設定変更
intra-mart Accel Platform のセットアップに必要なコンポーネントのインストールおよび設定を行います。
具体的な手順は「intra-mart Accel Platform セットアップガイド 」の「intra-mart Accel Platform を利用するためのミドルウェアのインストールと設定 」を参照してください。

5

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

intra-mart Accel Platform 構成ファイルの作成
intra-mart Accel Platform の設定およびwarファイルの出力を行います。
具体的な手順は「intra-mart Accel Platform セットアップガイド 」の「WARファイルの作成 」を参照してください。

注意Oracle WebLogic Server を利用する場合、下記のモジュールを選択しないでください。起動時にエラーが発生します。
ライブラリ > サードパーティ製ライブラリ > Metro
ライブラリ > サードパーティ製ライブラリ > OpenPortal WSRP

6

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

WebLogicの設定
WebLogicの設定を行います。
Oracle WebLogic Server 12c R2(12.2.1) のインストール手順については Oracle WebLogic Server 12c R2(12.2.1) のマニュアルを参照してください。

Java ヒープサイズの設定
Java ヒープサイズの設定を行います。
1. WebLogic環境設定の実行ファイルを編集する。
Java ヒープサイズの設定はWebLogic環境設定の実行ファイルを編集してください。
Windowsの場合は setDomainEnv.cmd、Linuxの場合は setDomainEnv.sh です。
環境設定の実行ファイルをテキストエディタで開き、最少ヒープサイズ、最大ヒープサイズおよびMetaspace領域の初期値、Metaspace領域の最大値を設定します。
Windowsの例
この例ではsetDomainEnv.cmdの「USER_MEM_ARGS」プロパティにインストール環境に応じたJavaヒープサイズ、Metaspace領域の設定をします。
・・・@REM IF USER_MEM_ARGS the environment variable is set, use it to override ALL MEM_ARGS values
set USER_MEM_ARGS=-Xms1024m -Xmx2048m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m
・・・

Linuxの例
この例ではsetDomainEnv.shの「USER_MEM_ARGS」プロパティにインストール環境に応じたJavaヒープサイズ、Metaspace領域の設定をします。
・・・# IF USER_MEM_ARGS the environment variable is set, use it to override ALL MEM_ARGS values
export USER_MEM_ARGS="-Xms1024m -Xmx2048m -XX:MetaspaceSize=256m XX:MaxMetaspaceSize=512m"
・・・

コラム
WebLogic Serverを開発モードで使用する際は、「USER_MEM_ARGS」プロパティに「-XX:CompileThreshold=8000」 を追加して設定してください。
2. WebLogicを再起動します。

Java VM引数の設定
Java VM引数の設定を行います。
1. WebLogic起動用実行ファイルを編集する。
Java VM引数の設定はWebLogic起動用の実行ファイルを編集してください。Windowsの場合はstartWebLogic.cmd、Linuxの場合は startWebLogic.sh です。
起動用の実行ファイルをテキストエディタで開き、環境変数 JAVA_OPTIONS にJava VM引数の設定を追記します。
Windowsの例
この例ではstartWebLogic.cmdの84行目にJava VM引数(-Duser.language=zh -Duser.country=CN)の設定を追記しています。

7

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01
・・・
call "%DOMAIN_HOME%\bin\setDomainEnv.cmd" %*set JAVA_OPTIONS=%JAVA_OPTIONS% -Duser.language=zh -Duser.country=CN
set SAVE_JAVA_OPTIONS=%JAVA_OPTIONS%
・・・

Linuxの例
この例ではstartWebLogic.shの82行目にJava VM引数(-Duser.language=zh -Duser.country=CN)の設定を追記しています。
・・・. ${DOMAIN_HOME}/bin/setDomainEnv.sh $*JAVA_OPTIONS="${JAVA_OPTIONS} -Duser.language=zh -Duser.country=CN"
SAVE_JAVA_OPTIONS="${JAVA_OPTIONS}"
・・・

コラム
カスタマーサクセスライセンスをご契約中の場合には、ライセンスポータルと通信してご契約内容の変更が自動反映されます。
WebLogic をインストールした環境からライセンスポータルへの通信にプロキシサーバを利用する場合は、次の JVM 引数の設定が必要です。
-DUseSunHttpHandle

WebLogic が HTTP 接続に Sun HTTP ハンドラを使用するか設定します。
プロキシサーバを利用する場合は、true を指定してください。

-Dhttps.proxyHost

プロキシサーバのホストURL-Dhttps.proxyPort

プロキシサーバのポート番号-Dhttps.proxyUser

プロキシサーバへの接続ユーザ-Dhttps.proxyPassword 接続ユーザのパスワード
カスタマーサクセスライセンスについての詳細は、「ライセンスの登録」を参照してください。
2. WebLogicを再起動します。

com.sun.mail.javax.mail.jar の差し替え
1. Jakarta Mail 1.6.7（jakarta.mail-1.6.7.jar）を以下のURLからダウンロードします。
https://jakartaee.github.io/mail-api/ （English）
2. 以下のファイルを退避してください。
Linux%ORACLE_HOME%/oracle_common/modules/com.sun.mail.javax.mail.jar

Windows%ORACLE_HOME%\oracle_common\modules\com.sun.mail.javax.mail.jar

3. ダウンロードしたファイルを以下のパスに配置してください。
Linux8

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01%ORACLE_HOME%/oracle_common/modules/jakarta.mail-1.6.7.jar

Windows%ORACLE_HOME%\oracle_common\modules\jakarta.mail-1.6.7.jar

4. 配置したファイルのファイル名を退避を行った元のファイルと同じになるようにリネームしてください。
Linuxmv %ORACLE_HOME%/oracle_common/modules/jakarta.mail-1.6.7.jar%ORACLE_HOME%/oracle_common/modules/com.sun.mail.javax.mail.jar

Windowsren %ORACLE_HOME%\oracle_common\modules\jakarta.mail-1.6.7.jar%ORACLE_HOME%\oracle_common\modules\com.sun.mail.javax.mail.jar

5. WebLogicを再起動します。

JAXBプロバイダの設定
JAXBプロバイダの設定を行います。

コラム
WebLogicで intra-mart Accel Platform を運用する場合、 JAXBプロバイダの設定を行ってください。
JAXBプロバイダの設定を行わない場合、会社・組織などのエクスポートを行うと正しいデータが出力されません。
1. 下記のシステムプロパティを設定することで、JAXBプロバイダの設定が可能です。
システムプロパティ

値

com.sun.xml.ws.spi.db.BindingContextFactory com.sun.xml.ws.db.glassfish.JAXBRIContextFactory
javax.xml.bind.JAXBContextFactory

com.sun.xml.bind.v2.ContextFactory

システムプロパティの指定はJava VM引数で指定します。上記のシステムプロパティを設定するには以下のJava VM引数に以下の設定を追記します。
-Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JAXBRIContextFactory Djavax.xml.bind.JAXBContextFactory=com.sun.xml.bind.v2.ContextFactory

注意
システムプロパティ javax.xml.bind.JAXBContextFactory は 2018 Winter 以降において有効なプロパティです。
2018 Summer 以前をご利用の場合は、システムプロパティ javax.xml.bind.JAXBContextFactory をjavax.xml.bind.JAXBContext と指定してください。
-Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JAXBRIContextFactory-Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactoryJava VM引数の設定方法については「Java VM引数の設定 」を参照してください。

タイムゾーンの設定
9

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01
タイムゾーンの設定を行います。

コラム
タイムゾーンの初期設定は、Java VMに依存します。

注意
タイムゾーンは、「設定ファイルリファレンス タイムゾーンマスタ」に存在するものを設定してください。

注意
この設定は運用開始前に行ってください。
運用開始後に変更した場合、日時データに不整合が発生します。
1. システムプロパティにタイムゾーンを設定します。
タイムゾーンはシステムプロパティ「user.timezone」で指定します。
システムプロパティの指定は Java VM 引数で行います。例えば、タイムゾーンを UTC に設定する場合は Java VM 引数に以下を追記します。
-Duser.timezone=UTC

Java VM引数の設定方法については「Java VM引数の設定 」を参照してください。

JTAの設定JTAの設定を行います。
テナント環境構築時などの時間がかかるトランザクション処理のために、JTAのタイムアウト時間を変更します。
1. 左メニューの [サービス]-[JTA] を選択します。

2. [タイムアウト] を変更し、[保存]をクリックします。これで、JTAの設定は終わりです。

10

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

データソースの設定
データソースの設定を行います。使用するデータベースに応じて設定を行ってください。

Oracleの設定
Oracleを使用する場合の設定を行います。
1. 左メニューの [サービス]-[JDBC]-[データ ソース] を選択します。
右画面の[新規]ボタンをクリックし、[汎用データ・ソース]を選択します。

11

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

2. [名前]、[JNDI名]、[データベースのタイプ]を設定し、[次へ]ボタンをクリックします。
データベースのタイプ
Oracleコラム[JNDI名]は intra-mart Accel Platform 構成ファイルの DataSourceマッピングの設定 の data-sourcemapping-config.xml において、<resource-ref-name> に記述したJNDI名を入力してください。
3. [データベース・ドライバ]を設定し、[次へ]ボタンをクリックします。
データベース・ドライバ
Oracle’s Driver (Thin) for Instance connections; Versions:Any12

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

コラム
使用するDBがプラガブル・データベース（PDB）の場合は「 Oracle’s Driver (Thin) for Service
connections; Versions:Any 」を選択します。
4. [次へ]ボタンをクリックします。

5. [データベース名]、[ホスト名]、[ポート]、[データベース・ユーザ名]、[パスワード] を設定し、[次へ]ボタンをクリックします。

6. [構成のテスト]を行い、接続テストに成功することを確認後、[次へ]ボタンをクリックします。
（接続テストに失敗する場合は、設定を再度見直してください）13

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

7. JDBC データ ソースのデプロイ先をチェックし、[終了]ボタンをクリックします。
これで、JDBCデータ ソースの登録は終わりです。

PostgreSQLの設定
PostgreSQLを使用する場合の設定を行います。

14

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01
コラム
PostgreSQLを使用する場合、予めJDBCドライバをWebLogicのクラスパスに通す必要があります。下記にその例を記載します。
1. JDBCドライバを %WEBLOGIC_HOME%/server/lib のディレクトリにコピーします。
2. Windowsの場合は %WEBLOGIC_HOME%/common/bin/commEnv.cmd 、Linuxの場合はcommEnv.sh を編集し、環境変数 WEBLOGIC_CLASSPATH にJDBCドライバのパスを追加します。
下記はWindowsの例です。

set
WEBLOGIC_CLASSPATH=%JAVA_HOME%\lib\tools.jar;%WL_HOME%\server\lib\weblogic_sp.jar;%WL_HOME%\server\lib\w
all.jar;%ANT_CONTRIB%/lib/ant-contrib.jar;%WL_HOME%\server\lib\postgresql-9.1-902.jdbc4.jar

1. 左メニューの [サービス]-[JDBC]-[データ ソース] を選択します。
右画面の[新規]ボタンをクリックし、[汎用データ・ソース]を選択します。

2. [名前]、[JNDI名]、[データベースのタイプ]を設定し、[次へ]ボタンをクリックします。
データベースのタイプ
PostgreSQL

15

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

コラム[JNDI名]は intra-mart Accel Platform 構成ファイルの DataSourceマッピングの設定 の data-sourcemapping-config.xml において、<resource-ref-name> に記述したJNDI名を入力してください。
3. [データベース・ドライバ]を設定し、[次へ]ボタンをクリックします。
データベース・ドライバ
PostgreSQL’s Driver (Type 4) Versions:Any

4. [次へ]ボタンをクリックします。

16

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

5. [データベース名]、[ホスト名]、[ポート]、[データベース・ユーザ名]、[パスワード] を設定し、[次へ]ボタンをクリックします。

6. [構成のテスト]を行い、接続テストに成功することを確認後、[次へ]ボタンをクリックします。
（接続テストに失敗する場合は、設定を再度見直してください）17

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

7. JDBC データ ソースのデプロイ先をチェックし、[終了]ボタンをクリックします。
これで、JDBCデータ ソースの登録は終わりです。

warファイルのデプロイwarファイルのデプロイを行います。
1. 左メニューの [デプロイメント] を選択します。

18

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

2. [インストール]ボタンをクリックします。

3. [パス]にwarファイルのフルパスを入力し、[次]ボタンをクリックします。

4. [次]ボタンをクリックします。

5. [次]ボタンをクリックします。

19

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

6. [終了]ボタンをクリックします。

7. [保存]ボタンをクリックします。これで、warファイルのデプロイは終わりです。

20

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

21

— intra-mart Accel Platform セットアップガイド (WebLogic編) 第12版 2023-04-01

テナント環境の構築
intra-mart Accel Platform のテナント環境を構築します。
具体的な手順は「テナント環境の構築 」を参照してください。

セットアップで困ったら・・・
アップデート・パッチの適用

22