セットアップガイド - NEC(Japan)...¾ Oracle Database 10g Release1 (10.1.0) ¾ Oracle Database 10g Release2 (10.2.0) ¾ Oracle Database 11g Release1 (11.1.0) ¾ MySQL Enterprise

WebOTX Process Conductor セットアップガイドバージョン：7.1 版数：第 4 版リリース：2008 年 11 月 Copyright(C) 2006,-2008 NEC Corporation. All rights reserved.

セットアップガイド２

2

目次

1. インストール .......................................................................................................................................3

1.1. 使用条件................................................................................................................................................. 3 1.1.1. 動作環境 .......................................................................................................................................... 3 1.1.2. インストール媒体 ............................................................................................................................ 6 1.1.3. データベースの準備（Oracleを利用する場合） ............................................................................. 6 1.1.4. データベースの準備（MySQLを利用する場合）............................................................................ 7 1.1.5. WebOTX Application Serverの準備 ................................................................................................ 9

1.2. インストール ........................................................................................................................................11 1.2.1. Windows版......................................................................................................................................11 1.2.2. HP-UX版/ Linux版/Solaris版 ........................................................................................................ 18 1.2.3. Windows(テストサーバ)................................................................................................................. 24

1.3. インストール後の作業 ......................................................................................................................... 27 1.4. アンインストール ................................................................................................................................ 29

1.4.1. Windows版..................................................................................................................................... 29 1.4.2. HP-UX版/Linux版/Solaris版 ......................................................................................................... 31 1.4.3. Windows(テストサーバ)................................................................................................................. 33

1.5. アンインストール後の作業 .................................................................................................................. 34 1.6. 動作確認............................................................................................................................................... 36

1.6.1. サンプルシステムの概要 ............................................................................................................... 36 1.6.2. サンプルの設定.............................................................................................................................. 37 1.6.3. サンプルの実行と結果確認............................................................................................................ 40 1.6.4. サンプルの設定解除 ...................................................................................................................... 42

3

1.インストール WebOTX Process Conductor のインストール方法、アンインストール方法について説明します。

1.1.使用条件

1.1.1.動作環境

WebOTX Process Conductor の動作環境について説明します。

WebOTX Process Conductor を動作させるのに必要なソフトウェアは次の通りです。

オペレーティング・システム

次のうちのいずれかを使用することができます。

Windows(x86)

・ Windows Server(R) 2003 (*1)

・ Windows Server(R) 2003 R2 (*1)

・ Windows (R) 2000 Server SP4

・ Windows (R) 2000 Advanced Server SP4

(*1) Datacenter Edition, Enterprise Edition, Standard Edition に対応

HP-UX(IPF)

・ HP-UX 11i v2(11.23) (64bit)

Linux(x86)

・ Red Hat Enterprise Linux AS/ES 4

・ MIRACLE LINUX V4.0

Solaris(SPARC)

・ Sun Solaris 10

Java 2 SDK, Standard Edition


J2SE 1.4.2_14 以上

J2SE 5.0

4

Java SE 6

データベース


Oracle Database 10g Release1 (10.1.0)



MySQL Enterprise Server 5.0.x(5.0.3 以降)

WebOTX Process Conductor では、オペレーティング・システムごとに、構成可能な Java 2 SDK

Standard Edition とデータベースの組み合わせが決まります。組み合わせごとの構成可否を以下

に示します。

◇Windows 版

Java SE Development Kit

J2SE 1.4.2 J2SE 5.0 Java SE 6

備考

Oracle ○ ○ ○ データベース

MySQL ○ ○ ×

(*1)

◇HP-UX 版



備考

Oracle ○ ○ × データベース

MySQL ○ ○ ×

(*1)(*2)

◇Linux 版



備考

Oracle ○ ○ ○ データベース

MySQL ○ ○ ×

(*1)

5

◇Solaris 版



備考

Oracle × ○ × データベース

MySQL × ○ ×

(*3)

(*1) MySQL がサポートされるのは、WebOTX Process Conductor を J2SE 1.4.2 と J2SE 5.0 で動作

させる場合のみです。

(*2) WebOTX Process Conductor を HP-UX 上で動作させる場合、Java SE 6 での動作はサポートさ

れません。

(*3) WebOTX Process Conductor を Solaris 上で動作させる場合、J2SE 1.4.2 と Java SE 6 での

動作はサポートされません。

アプリケーションサーバ


WebOTX Application Server V7.11 Standard-J Edition

WebOTX Application Server V7.11 Standard Edition

WebOTX Application Server V7.11 Enterprise Edition

WebOTX Application Server について、以降では WebOTX AS と記載します。

Web サーバ


WebOTX AS にバンドルされている Java ベースの Web サーバ

WebOTX AS にバンドルされている Apache ベースの Web サーバ（WebOTX Web サーバ）

※1

Apache HTTP Server 1.3.39/2.0.61 以上

Sun ONE Web Server 6.0 以上（64 ビット OS(Itanium/x64)では未サポート）

Sun Java System Web Server 6.1（64 ビット OS(Itanium/x64)では未サポート）

※1 WebOTX Web サーバは、Apache HTTP Server 1.3.39/2.0.61 をベースにしています。

WebOTX Process Conductor の動作に要求されるハードウェアリソースは次の通りです。

ハードディスク

50MB 以上

6

※ユーザが作成する BPEL プロセスやトランザクションのログなどが格納されるデータベー

スのための容量は含んでいません。

メモリ

推奨 1024MB 以上

1.1.2.インストール媒体

WebOTX Process Conductor をインストールするには、次の製品に付属の CD-ROM 媒体が必要です。

動作環境型番製品名

Windows Server 2003 /

Windows 2000 Server

UL1519-10AD

HP-UX(IPF) UQ2655-020A1

Linux UL4021-10U

Solaris(SPARC) UYHUAD-20F0

WebOTX Media V7.1(*1)

(*1) Solaris 版以外は、WebOTX Media V7.1 に加えて追加のインストール媒体が必要になりま

す。詳細は製品のご購入元にお問い合わせ下さい。

1.1.3.データベースの準備（Oracle を利用する場合）

Oracle を利用する場合の、WebOTX Process Conductor のインストール前に必要なデータベースの

準備について説明します。

1. JDBC ドライバ

Oracle 社の JDBC ドライバを WebOTX Process Conductor をインストールするマシンの

${INSTANCE_ROOT}/lib/ext ディレクトリにコピーします。WebOTX AS のインストール時に指定し

た J2SE のバージョンと WebOTX Process Conductor が利用する Oracle データベースのバージョ

ンを考慮して適切な JDBC ドライバを配置して下さい。

2. 注意事項

Oracle 11g R1 の JDBC ドライバを使用してデータベースとの接続を行う場合には、

KROWN(ORACLE技術情報ページ)#126806にて情報公開されているJDBCドライバのパッチを入

手・適用する必要があります。上記情報の確認ならびに回避策であるパッチの詳細や入手

方法につきましては、ORACLE 製品の購入元のベンダーに問合せください。

データベースインスタンスの文字セット(NLS_CHARACTERSET)は日本語がサポートされてい

る文字セットである必要があります。

3. 起動と接続確認

${INSTANCE_ROOT}は、

WebOTX Process

Conductor をインス

トールする WebOTX AS

ドメインのディレク

トリです。

Ex)

/opt/WebOTX/domains

/domain1

7

WebOTX Process Conductor のインストーラを起動する前に、Oracle データベースを起動しておい

て下さい。また、system ユーザでログインできることを確認して下さい。

root>./sqlplus system/change_on_install@ORCL

SQL*Plus: Release 10.1.0.2.0 - Production on Fri Sep 29 18:40:26 2006

Copyright (c) 1982, 2004, Oracle. All rights reserved.

Connected to:

Oracle Database 10g Enterprise Edition Release 10.1.0.2.0 - 64bit Production

With the Partitioning and Data Mining options

SQL>

上記の例では、SQL*Plus を用いて確認しています。

1.1.4.データベースの準備（MySQL を利用する場合）

MySQL を利用する場合の、WebOTX Process Conductor のインストール前に必要なデータベースの

準備について説明します。

1. JDBC ドライバ

Sun Microsystems 社が提供する MySQL 用 JDBC ドライバである MySQL Connector/J を WebOTX

Process Conductor をインストールするマシンの${INSTANCE_ROOT}/lib/ext ディレクトリにコピ

ーします。WebOTX Process Conductor が利用する MySQL データベースのバージョンが 5.0.x のた

め、MySQL Connector/J 5.1 以降を利用してください。

2. インスタンスの設定

WebOTX Process Conductor が利用するデータベースは、MySQL インストール時の規定値より以下

の手順で設定変更を行ったインスタンスである必要があります。他のデータベース利用アプリケ

ーションとインスタンスを共有する場合、互いの必要とする設定値が異なるなどで、予期せぬ問

題が発生する可能性があるため、WebOTX Process Conductor 専用にインスタンスを作成すること

を推奨します。

◇設定の変更手順

WebOTX Process Conductor が利用するデータベースを持つインスタンスが起動時に読み込む設定

ファイル(Windows の場合 my.ini、Unix 系 OS の場合 my.cnf)に以下の 2 行を追加します。既に同

一の設定項目が存在する場合(=の左側の文字列が同一の行が存在する場合)、追加ではなくその行

を以下の値で上書きしてください。

default-character-set=utf8

transaction-isolation=READ-COMMITTED

Ex)

[mysqld]以降に下記の 3行を追加します。

[mysqld]

${INSTANCE_ROOT}は、

WebOTX Process

Conductor をインス

トールする WebOTX AS

ドメインのディレク

トリです。

Ex)

/opt/WebOTX/domains

/domain1

8

～省略～

# for WebOTX Process Conductor

default-character-set=utf8

transaction-isolation=READ-COMMITTED

設定変更後、インスタンスを起動し、以下の SQL 文を発行し、Value カラムの値が設定した通り

の値(utf8、READ-COMMITTED)となっていることを確認します。

mysql> SHOW VARIABLES WHERE Variable_name='character_set_server' OR

Variable_name='tx_isolation';

+----------------------+----------------+

| Variable_name | Value |

+----------------------+----------------+

| character_set_server | utf8 |

| tx_isolation | READ-COMMITTED |

+----------------------+----------------+

3. 起動と接続確認

WebOTX Process Conductor のインストーラを起動する前に、MySQL データベースを起動しておい

て下さい。また、WebOTX Process Conductor のインストールを行うマシンから管理権限を持つユ

ーザ(root ユーザ等)でログインできること、を確認して下さい。

◇ログイン確認

root ユーザで下記のコマンドを実行し、以下の例のようにログインに成功することを確認しま

す。

Ex)

root> mysql -h dbserver -u root -p test

Enter password: **********

Welcome to the MySQL monitor. Commands end with ; or \g.

Your MySQL connection id is 1

Server version: 5.0.62-enterprise-gpl-nt-log MySQL Enterprise Server (GPL)

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

◇ユーザ権限確認(上記のログイン確認に引き続き実施する)

ログイン確認後、ログインに用いたユーザの権限が十分であることを次の SQL 文の発行結果より

確認します(Where 節の Host と User の値は、接続に用いたユーザに合致するよう適宜変更する必

要があります)。

Create_user_priv カラムと Grant_priv カラムの両方の値が権限を持っていることをあらわ

す’Y’であることを確認します。いずれかの値が Nである場合、Grant_priv カラムの値が Yで

あるユーザでログインし、GRANT 文を発行して権限を与えてください。

mysql> connect mysql

Connection id: 11

Current database: mysql

mysql> SELECT Host,User,Create_user_priv,Grant_priv FROM user WHERE Host='%' AND

User='root' \G

*************************** 1. row ***************************

Host: %

User: root

管理権限とは、ユーザ

の生成と削除、権限を

与えることが可能で

あることを指します。

9

Create_user_priv: Y

Grant_priv: Y

1 row in set (0.00 sec)

mysql>

(権限を与える場合の例)

mysql> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'password';

Query OK, 0 rows affected (0.00 sec)

mysql> GRANT GRANT OPTION ON *.* TO 'root'@'%' IDENTIFIED BY 'password';

Query OK, 0 rows affected (0.00 sec)

mysql>

1.1.5.WebOTX Application Server の準備

WebOTX Process Conductor のインストール前に必要な WebOTX AS の設定について説明します。

1. 外部 Web サーバを利用する場合

外部 Web サーバを利用する場合、Web コンテナを TP モニタ上で動作する設定にする必要がありま

す(WebOTX AS Standard Edition、または WebOTX AS Enterprise Edition 上で WebOTX Process

Conductor を利用する場合のみに必要な設定です)。

手順については、WebOTX AS のセットアップガイドを参照してください。

2. ドメインの起動確認

WebOTX Process Conductor のインストーラを起動する前に、WebOTX AS のドメインを起動してお

いて下さい。

Ex)

otxadmin> list-domains

List of domains:

domain1 running

WebOTXAdmin running

domain1 に WebOTX Process Conductor をインストールする場合、domain1 が running であること

を確認します。

[1.1.3]、または[1.1.4]にて JDBC ドライバのコピーを行った場合、設定を有効化するため、既に

ドメインが起動中であった場合でも、ドメインを一旦停止し、再度起動を行ってください。

※MySQL を利用する場合のみ、下記の手順を実施します。

3. タイマーサービスの状態確認

WebOTX Process Conductor は WebOTX AS が提供するタイマーサービスと異なる専用のタイマーサ

ービスを利用するため、既に WebOTX AS が提供するタイマーサービスを利用しているドメインに

インストールすることはできません。

WebOTX AS の管理ド

メイン

(WebOTXAdmin ドメ

イン)には、WebOTX

Process Conductor

をインストールで

きません。

ドメインの作成方

法については、

WebOTX AS のマニュ

アルの[WebOTX 運用

10

以下の手順で、状態を確認し、利用中であれば別のドメインを作成し、そちらのドメインに WebOTX

Process Conductor をインストールするようにしてください。

◇確認手順

運用管理コマンドでタイマーサービスのアプリケーション情報の取得を試みます。それぞれの場

合の実行結果を以下に示します。

タイマーサービスを利用していない場合）

otxadmin> get server.applications.j2ee-application.__ejb_container_timer_app.name

指定された名前

"server.applications.j2ee-application.__ejb_container_timer_app.name" に一致するオ

ブジェクトは存在しません。

CLI137 Command get failed.

otxadmin>

タイマーサービスを利用中の場合）


server.applications.j2ee-application.__ejb_container_timer_app.name =

__ejb_container_timer_app

otxadmin>

編(ドメインの運

用)] の [4.1 ドメ

インの生成と削除]

を参照してくださ

い。

11

1.2.インストール

インストールは必ず管理者権限があるユーザで行って下さい。また、インストール作業の前に、

WebOTX AS のドメインとデータベースを起動しておいて下さい。

1.2.1.Windows 版

WebOTX Process Conductor Windows 版のインストールについて説明します。

WebOTX AS メディアの CD-ROM 媒体を

CD-ROM ドライブに挿入すると、WebOTX

AS V7.1 のインストール画面が表示さ

れるので[WebOTX Process Conductor

V7.1]を選びます。

CD-ROM を挿入しても画面が自動的に

表示されない場合は、コマンドプロン

プトで<ドライブ>:\ フォルダに移動

し、「wo_setup.exe」を起動します。

※ <ドライブ>は、CD-ROM ドライブの

ドライブ文字です。

Windows インストーラが起動し「イン

ストールの準備中」というメッセージ

のあとに[WebOTX Process Conductor

V7.12 用の Install Shield ウィザード

へようこそ]の画面が表示されます。

「次へ」ボタンを押してください。

[ユーザ情報] 画面が表示されますの

で、[ユーザ名] ボックスと[所属] ボ

ックスに名前、所属を入力します。[ラ

イセンスキー] ボックスには、製品に

添付されている「ソフトウェア使用

認定証」の「製品番号」に記載されて

いる 19 桁の番号を正しく入力します。

入力した情報に間違いがなければ「次

へ」ボタンを押してください。

12

[インストール済みの J2SE SDK] 画面

が表示されます。WebOTX AS が利用し

ている J2SE が表示されますので、確

認後、「次へ」ボタンを押してくださ

い。

[インストール先のフォルダ] 画面が

表示されます。WebOTX AS のインスト

ールフォルダが表示されますので、確

認後、「次へ」ボタンを押してくださ

い。

[カスタムセットアップ] 画面が表示

されます。「次へ」ボタンを押してく

ださい。

「初期環境構築の選択」画面が表示さ

れます。初期環境を構築するかを選択

後、「次へ」ボタンを押してください。

「初期環境を構築しない」を選択した

場合、「インストールする準備ができ

ました」画面が表示されます。

データベースの準

備が整っていない

場合などは「初期環

境を構築しない」を

選択してください。

「初期環境を構築

しない」を選択した

場合、インストール

完了後、データベー

スの準備などが完

了したら、手動で初

期環境を構築する

必要があります。本

節の後半にある「初

期環境構築の再実

行」の手順を実施し

てください。

13

「WebOTX Application Server 製品情

報」画面が表示されます。ご利用の

Edition を選択後、「次へ」ボタンを

押してください。

Standard-J Edition を選択した場合、

[WebOTX Application Server 情報

(Standard-J)] 画面が表示されます。

[HTTP ポート番号]ボックスに、WebOTX

AS の HTTP ポート番号を入力します。

[ドメイン名]ボックスに、WebOTX

Process Conductor をインストールす

るドメイン名を入力します。

入力後、「次へ」ボタンを押して下さ

い。

Standard Edition または Enterprise

Edition を選択した場合、[WebOTX

Application Server 情報(Standard 以

上)] 画面が表示されます。

[HTTP 番号]ボックスに、WebOTX AS の

HTTP ポート番号を入力します。

[ドメイン名]ボックスに、WebOTX

Process Conductor をインストールす

るドメイン名を入力します。

[アプリケーショングループ名]ボッ

クスに、WebOTX Process Conductor 用

に生成するアプリケーショングルー

プ名を入力します。

[プロセスグループ名]ボックスに

WebOTX Process Conductor 用に生成す

るプロセスグループ名を入力します。


い。

[WebOTX

Application Server

情報(Standard-J)]

画面、[WebOTX

Appication Server

情報(Standard 以

上)] 画面で指定す

るドメインは、存在

するドメインを指

定して下さい。

また、ドメインは起

動しておいて下さ

い。

[WebOTX

Application Server

情報(Standard 以

上)] 画面で指定す

るアプリケーショ

ングループ名とプ

ロセスグループ名

は、存在しないもの

を指定して下さい。

Process Conductor

専用に新規に生成

されます。

14

[WebOTX Application Server ドメイン

情報] 画面が表示されます。

[ドメインユーザ名]ボックスに、ドメ

インの管理ユーザ名を入力します。

[ドメインポート番号]ボックスに、ド

メインのポート番号を入力します。

[ドメインパスワード]ボックスに、ド

メイの管理ユーザのパスワードを入

力します。入力後、「次へ」ボタンを

押して下さい。

[利用するデータベース製品の選択」

画面が表示されます。ご利用のデータ

ベースの製品名を選択後、「次へ」ボ

タンを押してください。

[Oracle 情報] 画面が表示されます。

[Oracle Net 接続識別子]ボックスに、

Oracle データベースの接続識別子を

入力します。

[Oracle ホスト名]ボックスに、Oracle

データベースが存在するホスト名を

入力します。

[Oracle ポート番号]ボックスに、

Oracle リスナのポート番号を入力し

ます。

[Oracle system ユーザパスワード]ボ

ックスに、system ユーザのパスワード

を入力します。


い。

15

[MySQL 情報] 画面が表示されます。

[データベース名]ボックスに、MySQL

データベースのデータベース名を入

力します。

[ホスト名]ボックスに、MySQL データ

ベースが存在するホスト名を入力し

ます。

[ポート番号]ボックスに、MySQL デー

タベースのポート番号を入力します。

[管理ユーザ名]ボックスに、MySQL デ

ータベースの管理ユーザ(GRANT と

CREATE USER 権限を持つユーザ)名を入

力します。

[管理ユーザのパスワード]ボックス

に、MySQL データベースの管理ユーザ

のパスワードを入力します。


い。

「インストールする準備ができまし

た」画面が表示されます。

「次へ」ボタンを押すとインストール

処理が開始されます。

[インストールしています] 画面が表

示され、ファイルのコピーが始まりま

す。

途中で何度かコマンドプロンプトの

画面が表示されます。これらの画面は

自動で消えますので、しばらくお待ち

下さい。

16

インストールが終了すると、完了画面

が表示されます。

この画面が表示されたら「完了」ボタ

ンを押してください。これでインスト

ールは完了です。

[初期環境の構築] 画面で、初期環境を構築するように選択した場合は、環境に合わせて WebOTX

Process Conductor の初期環境の構築が行われます。実行結果は、<WebOTX AS インストールディ

レクトリ>\ProcessConductor\install\INSTALL.log で確認できます。

データベースや WebOTX AS への接続に失敗すると、下記のような画面が表示され、初期環境構築

は行われません。この画面が表示された場合には、問題を取り除いた後、再度初期環境を構築す

る必要があります。以下の [初期環境構築の再実行] の手順を行ってください。

[初期環境の構築]画面で、初期環境を構築しないように選択した場合も、インストール終了後、

データベースなどの準備ができた時点で、以下の [初期環境構築の再実行] の手順を行って下

さい。

初期環境構築の再実行

[初期環境の構築]画面で初期環境を構築するように選択し、正常に初期環境の構築ができていた

場合(INSTALL.log に問題がない場合)は、ここで述べる手順は不要です。

コントロールパネルの[プログラ

ムの追加と削除]から[WebOTX

Process Conductor V7.12]を選択

し[変更]ボタンを押します。

17

Windows インストーラが起動し

「インストールの準備中」という

メッセージのあとに[WebOTX

Process Conductor V7.12 用の

Install Shieldウィザードへよう

こそ]の画面が表示されます。

「次へ」ボタンを押してくださ

い。

[プログラムの保守」画面が表示

されます。変更を選択後、「次へ」

ボタンを押してください。

[カスタムセットアップ] 画面が

表示されます。「次へ」ボタンを

押してください。以降は初回イン

ストール時と同様の手順となり

ます。

失敗した場合、原因を取り除いた後、初期環境構築の再実行を行ってください。

正常に実行された場合、1.3 インストール後の作業を実施します。

18

1.2.2.HP-UX 版/ Linux 版/Solaris 版

HP-UX 版/ Linux 版/Solaris 版の WebOTX Process Conductor のインストール手順について説明し

ます。

ライセンスの登録

WebOTX Process Conductor のライセンスを登録する手順について説明します。

1. ライセンス登録

WebOTX Process Conductor のライセンス登録を行います。root ユーザでログインし、次の手順で

ライセンス登録を行ってください。WebOTX Process Conductor を複数 CPU のマシンで使用する場

合は、マシンの CPU 数にあわせて CU ライセンスの追加が必要です。CPU 数と CU ライセンス数の

対応については次の通りです。

CPU 数 CU ライセンス数

1 0

2 1

3～4 2

5～6 4

7～8 6

9～16 8

17～32 16

33～64 32

ライセンス登録は次のコマンドで行います。

root> /opt/share.nec/bin/OTXLAdd

「Please Input License Code」と表示されたら製品のライセンスキーを入力します。

製品の「ライセンスキー」は製品購入時に添付される「ソフトウェア使用認定証」の「製品番号」

に記載されている 19 桁の番号です。ライセンス登録作業が成功したら「Command Succeeded.」

と表示され OTXLAdd コマンドが終了します。購入された WebOTX 製品が複数ある場合は OTXLAdd

コマンドを複数回実行して各製品のライセンス登録を行ってください。

ライセンスの登録情報一覧は次のコマンドで確認することができます。

root> /opt/share.nec/bin/OTXLChk

ライセンス登録を行ったのにライセンス情報が表示されない場合は、ライセンス登録作業が失敗

しています。次の点に注意しながら再度ライセンス登録を行ってください。

・root ユーザでログインしていること

・ライセンスキーを正しく入力していること

誤ってライセンス登録した場合は次の方法でライセンスを削除することができます。WebOTX のラ

イセンス情報削除は、OTXLDel コマンドを使用します。

root> /opt/share.nec/bin/OTXLDel 34

19

インストールスクリプトの実行

インストールスクリプトを使用したインストール方法を説明します。

ログイン名 root でログインします。

login: root

CD-ROM ドライブに WebOTX メディア CD-ROM の一枚目を挿入してマウントします。自動的にマウ

ントされない場合には次のコマンドでマウントしてください。

HP-UX 版)

root> cd / root> mount -F cdfs -r /dev/dsk/c1t2d0 /SD_CDROM

Linux 版)

root> cd / root> mount -t iso0660 /dev/cdrom /media/cdrom

Solaris 版)

root> cd / root> mount -F cdfs -r /dev/dsk/c0t6d0s2 /cdrom

※上記の mount コマンドで指定したスペシャルファイル名は CD-ROM ドライブの SCSI ID によっ

て異なります。マシンの設定にあわせて指定してください。

CD-ROM のインストールスクリプトのあるディレクトリへ移動してください。

HP-UX 版)

root> cd /SD_CDROM/OTXPCOND/HP_UX/

Linux 版)

root> cd /media/cdrom/OTXPCOND/LINUX/

Solaris 版)

root> cd /cdrom/OTXPCOND/SUN

インストールスクリプトを起動してください。

root> ./PCONDJINST.SH

インストールするファイルのオーナ指定の選択を行います。ファイルのオーナを root にする場合

は「n」を選択してください。ファイルオーナを WebOTX AS 運用管理ユーザアカウントにする場合

は「y」を選択して下さい。

root>./PCONDJINST.SH ## Executing WebOTX Process Conductor Install script. License check OK. Would you like to install as WebOTX Operation User? (Default: y)

続けて、インストールするファイルのオーナを WebOTX AS 運用管理ユーザアカウントにする場合

20

は、WebOTX AS 運用管理ユーザアカウントのユーザ名とグループ名を入力して下さい。

Enter the user name that administers the WebOTX server. necuser Enter the group name that administers the WebOTX server. necgroup

インストール開始確認画面が表示されます。

****************************************************************** * Installation of WebOTX Process Conductor on your computer. * * To continue, enter y. * * Enter q to exit the installation. [y, q] (Default: y) * ******************************************************************

インストールを開始するには y を入力してください。キャンセルするには q を入力してくださ

い。キャンセルした場合、インストールスクリプトは終了します。

WebOTX Process Conductor のファイルが順次コピーされます。

CD-ROM をアンマウントします。

HP-UX 版)

root> cd / root> umount /SD_CDROM

Linux 版)

root> cd / root> umount /media/cdrom

Solaris 版)

・ボリューム管理 (vold) を使用して自動的にマウントされた場合

root> cd / root> eject

・手動で mount コマンドによりマウントを行った場合

root> cd / root> umount /cdrom

環境変数の設定

環境変数"JAVA_HOME"に JDK がインストールされているディレクトリを設定してください。

（例）

・sh の場合

root> JAVA_HOME=/usr/jdk/jdk1.5.0_16 root> export JAVA_HOME

・csh の場合

root> setenv JAVA_HOME /usr/jdk/jdk1.5.0_16

21

初期環境の構築

続けて、環境に合わせて WebOTX Process Conductor の初期環境を構築します。

1. プロパティファイルの編集

プロパティファイル

(/opt/WebOTX/ProcessConductor/install/setup_processconductor.properties)を、環境に合わ

せて編集します。

root> cd /opt/WebOTX/ProcessConductor/install

root> vi setup_processconductor.properties

以下の表を参照し、各プロパティ値(右辺)を環境に合わせて編集して下さい。ただし、表中の色

つきのプロパティ値は変更しないで下さい。

※「プロパティ値の例」の列の下線の値は、デフォルト値を示す。

プロパティ名プロパティ値の例説明

local.os unix OS 種別です。

jre.home /usr/jdk/jdk1.5.0_16 WebOTX AS が利用する Java へのパスを

指定します。

webotx.home /opt/WebOTX WebOTX AS のインストールディレクトリで

す。

webotx.instance

.root

/opt/WebOTX/domains/domain1 WebOTX Process Conductor をインスト

ールするドメインのディレクトリを指定し

ます。

webotx.port 6212 WebOTX Process Conductor をインスト

ールするドメインのポート番号を指定し

ます。

webotx.domain domain1 WebOTX Process Conductor をインスト

ールするドメイン名を指定します。

webotx.edition STD WebOTX AS の Edition を指定します。

Standard-J Edition : STDJ

Standard Edition : STD

Enterprise Edition : ENT

webotx.apgroup pcondapg WebOTX Process Conductor をインスト

ールするアプリケーショングループ名を

指定します。webotx.editionが STDJの

場合は、以下のように値を空白にして下

さい。

webotx.apgroup =

webotx.pgroup pcondpg WebOTX Process Conductor をインスト

ールするプロセスグループ名を指定しま

す。webotx.editionが STDJの場合は、

以下のように値を空白にして下さい。

webotx.pgroup =

webotx.http.por

t

80 WebOTX AS の HTTP ポートを指定します。

processconducto /opt/WebOTX/ProcessConducto WebOTX Process Conductor のインスト

webotx.domainで指

定するドメインは、

存在するドメイン


webotx.apgroup と

webotx.pgroupで指

定するアプリケー

ショングループ名

とプロセスグルー

プ名は、存在しない

ものを指定して下

さい。新規に生成さ

れます。

22

r.home r ールディレクトリです。

db.type oracle | mysql RDBMS の種別を指定。本バージョンで有

効な値は oracle と mysql。

db.instance [oracle]ORCL

[mysql]test

[oracle]Oracle データベースの接続識

別子を指定。

[mysql] MySQL のデータベース名を指

定。

db.host localhost データベースが存在するホスト名を指

定。

db.port [oracle]1521

[mysql]3306

[oracle]Oracle リスナのポート番号を

指定。

[mysql]MySQL サーバのポート番号を指

定。

2. Ant の実行

Ant を実行して初期環境を構築します。

WebOTX AS のドメインが起動していること、データベースが起動していることを確認し、初期環

境構築用 Ant スクリプトを実行します。このとき、下記にあげるパラメータを「-D${パラメータ

名}=${パラメータ値}」形式でコマンドライン引数として渡す必要があります。

パラメータ名パラメータ値の例説明

webotx.user admin インストールする WebOTX のドメインの管

理ユーザ名を指定。

webotx.password adminadmin インストールする WebOTX のドメインの管

理ユーザのパスワードを指定。

db.user [oracle]<<指定なし>>

[mysql]root

[oracle] 指定なし(設定ファイルのプロ

パティの db.type=oracle の場合は指

定を無視)

[mysql] GRANT と CREATE USER 権限を

持つユーザ名を指定。デフォルトは、

root。

【注】MySQL では、root ユーザが必ずい

るわけではない。ユーザ名が変更されて

いる可能性もある。

db.password [oracle] SYSTEM ユーザのパスワードを

指定。

[mysql] db.user のパスワードを指定。

利用するデータベースごとの実行例を以下にあげます。

Oracle 利用時の例）

root> cd /opt/WebOTX/ProcessConductor/install root> /opt/WebOTX/lib/ant/bin/ant -Dwebotx.user=admin -Dwebotx.password=adminadmin -Ddb.password=change_on_install -f ant_setup_processconductor.xml -logfile INSTALL.log INSTALL

MySQL 利用時の例）

root> cd /opt/WebOTX/ProcessConductor/install

Ant の実行前に、

WebOTX AS のドメイ

ンとデータベース

を必ず起動してお

いて下さい。

23

root> /opt/WebOTX/lib/ant/bin/ant -Dwebotx.user=admin -Dwebotx.password=adminadmin -Ddb.user=root -Ddb.password=password -f ant_setup_processconductor.xml -logfile INSTALL.log INSTALL

初期環境の構築に失敗していた場合には、一旦、アンインストール手順の[設定情報のクリア]を

実施して下さい。その後、WebOTX AS のドメインが起動していること、データベースが起動して

いること、プロパティファイルの各設定値が環境に合っていることを確認し、上記のコマンドを

再度実行して下さい。

この後、1.3 インストール後の作業を実施します。

INSTALL.log 内に、

失敗しているター

ゲットや WebOTX AS

運用コマンド

(otxadmin)の実行

で失敗している記

録がある場合、初期

環境の構築に失敗

しています。

24

1.2.3.Windows(テストサーバ)

WebOTX 開発環境のテストサーバとして WebOTX Process Conductor をインストールした後の、初期

環境の構築手順について説明します。

1. プロパティファイルの編集

プロパティファイル(<WebOTX AS のインストールディレクトリ

>\ProcessConductor\install\setup_processconductor.properties)を、以下の表を参照し、各プ

ロパティ値(右辺)を環境に合わせて編集して下さい。ただし、表中の色つきのプロパティ値は変更

しないで下さい。

プロパティ名プロパティ値の例説明

local.os windows OS 種別です。

jre.home C:\\jdk1.5.0_16 WebOTX AS が利用する Java へのパスを

指定します。

webotx.home C:\\WebOTX WebOTX AS のインストールディレクトリで

す。

webotx.instance

.root

C:\\WebOTX\\domains\\domain

1

WebOTX Process Conductor をインスト

ールするドメインのディレクトリを指定し

ます。

webotx.port 6212 WebOTX Process Conductor をインスト

ールするドメインのポート番号を指定し

ます。

webotx.domain domain1 WebOTX Process Conductor をインスト

ールするドメイン名を指定します。

webotx.edition STD WebOTX AS の Edition を指定します。

Standard-J Edition : STDJ

Standard Edition : STD

Enterprise Edition : ENT

webotx.apgroup pcondapg WebOTX Process Conductor をインスト

ールするアプリケーショングループ名を

指定します。webotx.editionが STDJの

場合は、以下のように値を空白にして下

さい。

webotx.apgroup =

webotx.pgroup pcondpg WebOTX Process Conductor をインスト

ールするプロセスグループ名を指定しま

す。webotx.editionが STDJの場合は、

以下のように値を空白にして下さい。

webotx.pgroup =

webotx.http.por

t

80 WebOTX AS の HTTP ポートを指定します。

processconducto

r.home

C:\\WebOTX\\ProcessConducto

r

WebOTX Process Conductor のインスト

ールディレクトリです。

db.type oracle | mysql RDBMS の種別を指定。本バージョンで有

効な値は oracle と mysql。

db.instance [oracle]ORCL [oracle]Oracle データベースの接続識

webotx.domain で指

定するドメインは、

存在するドメイン


webotx.apgroup と

webotx.pgroup で指

定するアプリケー

ショングループ名

とプロセスグルー

プ名は、存在しない

ものを指定して下

さい。新規に生成さ

れます。

25

[mysql]test 別子を指定。

[mysql] MySQL のデータベース名を指

定。

db.host localhost データベースが存在するホスト名を指

定。

db.port [oracle]1521

[mysql]3306

[oracle]Oracle リスナのポート番号を

指定。

[mysql]MySQL サーバのポート番号を指

定。

セパレータが \\となることに注意して下さい。

2. Ant の実行

Ant を実行して初期環境を構築します。

WebOTX AS のドメインが起動していること、データベースが起動していることを確認し、初期環境

構築用 Ant スクリプトを実行します。このとき、下記にあげるパラメータを「-D${パラメータ

名}=${パラメータ値}」形式でコマンドライン引数として渡す必要があります。

パラメータ名パラメータ値の例説明

webotx.user admin インストールする WebOTX のドメインの管

理ユーザ名を指定。

webotx.password adminadmin インストールする WebOTX のドメインの管

理ユーザのパスワードを指定。

db.user [oracle]<<指定なし>>

[mysql]root

[oracle] 指定なし(設定ファイルのプロ

パティの db.type=oracle の場合は指

定を無視)

[mysql] GRANT と CREATE USER 権限を

持つユーザ名を指定。デフォルトは、

root。

【注】MySQL では、root ユーザが必ずい

るわけではない。ユーザ名が変更されて

いる可能性もある。

db.password [oracle] SYSTEM ユーザのパスワードを

指定。

[mysql] db.user のパスワードを指定。

利用するデータベースごとの実行例を以下にあげます。JAVA_HOME には、WebOTX AS が利用する JDK

へのパスを指定します。


C:\WebOTX\ProcessConductor\install>set JAVA_HOME=C:\jdk1.5.0_16 C:\WebOTX\ProcessConductor\install>C:\WebOTX\lib\ant\bin\ant -Dwebotx.user=admin -Dwebotx.password=adminadmin -Ddb.password=change_on_install -f ant_setup_processconductor.xml -logfile INSTALL.log INSTALL


C:\WebOTX\ProcessConductor\install>set JAVA_HOME=C:\jdk1.5.0_16 C:\WebOTX\ProcessConductor\install>C:\WebOTX\lib\ant\bin\ant

。

Ant の実行前に、

WebOTX AS のドメイ

ンとデータベース

を必ず起動してお

いて下さい。

26

-Dwebotx.user=admin -Dwebotx.password=adminadmin -Ddb.user=root -Ddb.password=password -f ant_setup_processconductor.xml -logfile INSTALL.log INSTALL

初期環境の構築に失敗していた場合には、一旦、アンインストール手順の[設定情報のクリア]を実

施して下さい。その後、WebOTX AS のドメインが起動していること、データベースが起動している

こと、プロパティファイルの各設定値が環境に合っていることを確認し、上記のコマンドを再度実

行して下さい。

この後、1.3 インストール後の作業を実施します。

27

1.3.インストール後の作業

インストール完了後、以下の手順を実施して下さい。

※Oracle を利用する場合は、手順 1と 2 を順に実施してください。手順 3は不要です。

※MySQL を利用する場合は、手順 2と 3を順に実施してください。手順 1は不要です。

1. SQL 文の実行

WebOTX Process Conductor が利用する Oracle データベースに sys ユーザでログインし、以下の

SQL を発行して下さい。

GRANT SELECT ON DBA_PENDING_TRANSACTIONS TO EBizAdmin;

Ex)

C:\>sqlplus /nolog SQL>CONNECT /@ORCL AS SYSDBA; SQL>GRANT SELECT ON DBA_PENDING_TRANSACTIONS TO EBizAdmin;

WebOTX Process Conductor が利用する Oracle データベースが Oracle Database 10g R2 以降で

ある場合には、追加で以下の SQL を発行して下さい。

GRANT EXECUTE ON SYS.DBMS_SYSTEM TO EBizAdmin;

Ex)

C:\>sqlplus /nolog SQL>CONNECT /@ORCL AS SYSDBA; SQL> GRANT EXECUTE ON SYS.DBMS_SYSTEM TO EBizAdmin;

2. WebOTX AS のドメインを起動

WebOTX AS Standard-J Edition

otxadmin コマンドで WebOTX Process Conductor をインストールしたドメインを起動します。

Ex) domain1 にインストールした場合

otxadmin>start-domain domain1

WebOTX AS Standard Edition、または WebOTX Enterprise Edition

WebOTX AS を再起動します。

サービスを停止します。

root> /etc/init.d/WOAgentSvc stop

サービスを起動します。

root> /etc/init.d/WOAgentSvc start

28

3. タイマーサービスの巻き戻し

WebOTX Process Conductor のインストール処理において、WebOTX AS 付属のタイマーサービスが

WebOTX Process Conductor 専用のタイマーサービスに置き換えられています。この処理を以下の

手順で元に戻します。

WebOTX AS のドメインが起動していること(実行結果が running であること)を確認します。


List of domains:

domain1 running

WebOTXAdmin running

<WebOTX AS のインストールディレクトリ>/install/applications の

__ejb_container_timer_app.ear を削除し、__ejb_container_timer_app.ear.org を

__ejb_container_timer_app.ear にリネームします。

Ex）UNIX 系 OS の場合

root> cd /opt/WebOTX/lib/install/applications

root> rm __ejb_container_timer_app.ear

root> mv __ejb_container_timer_app.ear.org __ejb_container_timer_app.ear

29

1.4.アンインストール

アンインストールは必ず管理者権限があるユーザで行ってください。また、アンインストール作業の

前に、WebOTX AS のドメインとデータベースを起動しておいて下さい。

1.4.1.Windows 版

Windows 版の WebOTX Process Conductor のアンインストール手順について説明します。

1. 設定情報のクリア

WebOTX Process Conductor が設定/記録した、WebOTX AS やデータベース上の情報をクリアしま

す。

下記のようにバッチファイルを実行します。オプションには、UNINSTALL を指定します。WebOTX AS

の管理ユーザ名とパスワード、およびデータベースの管理ユーザ名(MySQL 利用時のみ必要、

Oracle 利用時は不要)とパスワードは適宜環境に合わせて下さい。


C:\WebOTX\ProcessConductor\install>ant_setup_processconductor.bat UNINSTALL WebOTX Application Server の管理ユーザ名を入力して下さい。 admin WebOTX Application Server の管理ユーザのパスワードを入力して下さい。 adminadmin Oracle の system ユーザのパスワードを入力して下さい。 change_on_install "WebOTX Process Conductor をアンインストールしますか。[y or q]" y


C:\WebOTX\ProcessConductor\install>ant_setup_processconductor.bat UNINSTALL WebOTX Application Server の管理ユーザ名を入力して下さい。 admin WebOTX Application Server の管理ユーザのパスワードを入力して下さい。 adminadmin MySQL の管理ユーザ名を入力して下さい。 root MySQL の管理ユーザのパスワードを入力して下さい。 password "WebOTX Process Conductor をアンインストールしますか。[y or q]" y

UNINSTALL.log で実行結果を確認し、処理に失敗していた場合は、WebOTX AS のドメインが起動し

ていること、データベースが起動していること、setup_processconductor.properties の各プロ

パティ値が適切であることを確認し、再度実行して下さい。

2. プログラムの追加と削除

30

コントロールパネルの[プログラ

ムの追加と削除]から[WebOTX

Process Conductor V7.12]を選択

し[削除」ボタンを押します。

3. ディレクトリの削除

<WebOTX AS インストールディレクトリ>\ProcessConductor ディレクトリを手動で削除します。

4. アンインストール後の作業

1.5 アンインストール後の作業を実施します。

31

1.4.2.HP-UX 版/Linux 版/Solaris 版

HP-UX 版/Linux 版/Solaris 版の WebOTX Process Conductor のアンインストール手順について説

明します。

1. 環境変数の設定

環境変数"JAVA_HOME"に JDK がインストールされているディレクトリを設定してください。

（例）

・sh の場合

root> JAVA_HOME=/usr/jdk/jdk1.5.0_16 root> export JAVA_HOME

・csh の場合

root> setenv JAVA_HOME /usr/jdk/jdk1.5.0_16

2. 設定情報のクリア

WebOTX Process Conductor が設定/記録した、WebOTX AS やデータベース上の情報をクリアします。

下記のようにシェルスクリプトを実行します。オプションには、UNINSTALL を指定します。WebOTX

AS の管理ユーザ名とパスワード、およびデータベースの管理ユーザ名(MySQL 利用時のみ必要、



root> cd /opt/WebOTX/ProcessConductor/install root> ./ant_setup_processconductor.sh UNINSTALL Enter the user name that administers the WebOTX Application Server domain. admin Enter the password that administers the WebOTX Application Server domain. adminadmin Enter the system user password of Oracle Database. change_on_install To continue, input y. Input q to exit. [y, q] ｙ


root> cd /opt/WebOTX/ProcessConductor/install root> ./ant_setup_processconductor.sh UNINSTALL Enter the user name that administers the WebOTX Application Server domain. admin Enter the password that administers the WebOTX Application Server domain. adminadmin Enter the system user name of MySQL. root Enter the system user password of MySQL.

32

password To continue, input y. Input q to exit. [y, q] ｙ




3. パッケージの削除

WebOTX Process Conductor のパッケージを削除します。

HP-UX 版)

root> swremove OTXPCOND

Linux 版)

root> rpm -e OTXPCOND

Solaris 版)

root> pkgrm OTXPCOND

4. ディレクトリの削除

/opt/WebOTX/ProcessConductor ディレクトリを削除します。

5. アンインストール後の作業

1.5 アンインストール後の作業を実施します。

33

1.4.3.Windows(テストサーバ)

WebOTX 開発環境のテストサーバとしての WebOTX Process Conductor が設定/記録した WebOTX AS

やデータベース上の情報をクリアする手順を説明します。

下記のようにバッチファイルを実行します。オプションには、UNINSTALL を指定します。WebOTX AS

の管理ユーザ名とパスワード、およびデータベースの管理ユーザ名(MySQL 利用時のみ必要、



C:\WebOTX\ProcessConductor\install>ant_setup_processconductor.bat UNINSTALL WebOTX Application Server の管理ユーザ名を入力して下さい。 admin WebOTX Application Server の管理ユーザのパスワードを入力して下さい。 adminadmin Oracle の system ユーザのパスワードを入力して下さい。 change_on_install "WebOTX Process Conductor をアンインストールしますか。[y or q]" y


C:\WebOTX\ProcessConductor\install>ant_setup_processconductor.bat UNINSTALL WebOTX Application Server の管理ユーザ名を入力して下さい。 admin WebOTX Application Server の管理ユーザのパスワードを入力して下さい。 adminadmin MySQL の管理ユーザ名を入力して下さい。 root MySQL の管理ユーザのパスワードを入力して下さい。 password "WebOTX Process Conductor をアンインストールしますか。[y or q]" y




この後、1.5 アンインストール後の作業を実施します。

34

1.5.アンインストール後の作業

WebOTX AS のドメインが停止していること(実行結果が not running であること)を確認します。


List of domains:

domain1 not running

WebOTXAdmin not running

WebOTX Process Conductor をインストールしていたドメイン配下の domain.xml をエディタで開

いて、__ejb_container_timer_app の j2ee-application 要素と application-ref 要素をコメント

アウト(で該当要素を囲む)する。

Ex)

root> cd /opt/WebOTX/domains/domain1/config

root> vi domain.xml

変更前の domain.xml 抜粋）

～省略～

<domain ...>

<applications>

<j2ee-application directory-deployed="false" dynamic-rmi-iiop="true"

enabled="true"

location="${com.nec.webotx.instanceRoot}/applications/j2ee-apps/__ejb_container_tim

er_app" name="__ejb_container_timer_app" object-type="system-all">

<description>TimerService for WebOTX Process Conductor</description>

</j2ee-application>

～省略～

<applications>

～省略～

<servers>

<server ...>

～省略～

<application-ref enabled="true" exclude="false"

ref="__ejb_container_timer_app" virtual-servers="server"/>

～省略～

</server>

</servers>

</domain>

変更後の domain.xml 抜粋）

～省略～

<domain ...>

<applications>



～省略～

<applications>

～省略～

<servers>

<server ...>

～省略～

35



～省略～

</server>

</servers>

</domain>

インストール対象のドメイン配下の下記のフォルダを削除します。

${INSTANCE_ROOT}/applications/j2ee-apps/__ejb_container_timer_app

${INSTANCE_ROOT}/generated/ejb/j2ee-apps/__ejb_container_timer_app

Ex）

root> cd /opt/WebOTX/domains/domain1/applications/j2ee-apps/

root> rm -rf __ejb_container_timer_app

root> cd /opt/WebOTX/domains/domain1/generated/ejb/j2ee-apps/

root> rm -rf __ejb_container_timer_app

インストール対象のドメインを起動します。

/etc/init.d/WOAgentSvc start

ドメインの起動が完了したら、以下の手順を実行してドメインでタイマーサービスを利用してい

ない状態になっていることを確認します。

◇確認手順

運用管理コマンドでタイマーサービスのアプリケーション情報の取得を試みます。それぞれの場

合の実行結果を以下に示します。

タイマーサービスを利用していない場合）


指定された名前

"server.applications.j2ee-application.__ejb_container_timer_app.name" に一致するオ

ブジェクトは存在しません。

CLI137 Command get failed.

otxadmin>

タイマーサービスを利用中の場合）


server.applications.j2ee-application.__ejb_container_timer_app.name =

__ejb_container_timer_app

otxadmin>

36

1.6.動作確認

1.6.1.サンプルシステムの概要

インストール完了後、製品に付属のサンプル BPEL プロセスを登録/実行し、製品の動作を確認します。

サンプルシステムの概要を示します。

サンプルシステムは、外部 Web サービスを統合する WebOTX Process Conductor をクライアントアプリ

ケーションから利用するという構成をしています。

サンプルの動作を順を追って説明します。

1. クライアントアプリケーションを実行すると、指定した文字列を含む SOAP メッセージを作成し

て WebOTX Process Conductor に送信します。

2. WebOTX Process Conductor がメッセージを受信します。

3. WebOTX Process Conductor は受信したデータを変数に格納します。

4. WebOTX Process Conductor は格納した変数を含む SOAP メッセージを作成して外部 Web サービス

に送信します。

5. 外部 Web サービスがメッセージを受信します。

6. 外部 Web サービスは受信したデータを使用してサービスを実行します。本サンプルでは受信した

メッセージの文字数をカウントして受信したデータに付加するというサービスを実行します。

7. 外部 Web サービスはサービスの実行結果から返信メッセージを作成して WebOTX Process

Conductor に送信します。

8. WebOTX Process Conductor は外部サービスから返信されたデータを変数に格納します。

9. WebOTX Process Conductor は格納した変数を含む SOAP メッセージを作成してクライアントアプ

リケーションに返信します。

Webサービス

Process Conductor

Web サービス

37

1.6.2.サンプルの設定

サンプルを実行するための事前準備について説明します。

1. 外部 Web サービスの配備

BPEL プロセスから呼ばれる外部 Web サービスを WebOTX AS に配備する手順について説明します。

外部 Web サービスは、次の場所に格納されています。

<WebOTX AS のインストールディレクトリ>/ProcessConductor/sample/war/sampleService.war

WebOTX AS Standard-J Edition の場合

otxadmin コマンドで以下のコマンドを実行します。

deploy --user <admin_user> --password <admin_password> --host localhost --port <port_number>

--force=true --name=sampleService --contextroot sampleService --echo=true --upload=true

"<WebOTX AS のインストールディレクトリ>/ProcessConductor/sample/war/sampleService.war"

<>で囲まれた箇所は、環境に合わせて適宜変更して下さい。

Ex)

otxadmin>deploy --user admin --password adminadmin --host localhost --port 6212

--force=true --name=sampleService --contextroot sampleService --echo=true

--upload=true "/opt/WebOTX/ProcessConductor/sample/war/sampleService.war"

実際には、改行を含まずにコマンドを入力して下さい。

WebOTX AS Standard Edition または Enterprise Edition の場合

otxadmin コマンドで以下のコマンドを実行します。

deploy --user <admin_user> --password <admin_password> --host localhost --port <port_number>

--force=true --apgroup <apg_name> --pgroup <pg_name> --name=sampleService --contextroot

sampleService --echo=true --upload=true "<WebOTX AS のインストールディレクトリ

>/ProcessConductor/sample/war/sampleService.war"


Ex)

otxadmin> deploy --user admin --password adminadmin --host localhost --port 6212

--force=true --apgroup pcondapg --pgroup pcondpg --name=sampleService --contextroot

sampleService --echo=true --upload=true

"/opt/WebOTX/ProcessConductor/sample/war/sampleService.war"

実際には、改行を含まずにコマンドを入力して下さい。

38

2. BPAR ファイルの登録

WebOTX Process Conductor に BPAR ファイルを登録する手順について説明します。

サンプルの BPAR ファイルは次の場所に格納してあります。

<WebOTX AS のインストールディレクトリ>/ProcessConductor/sample/bpar/sample.bpar

Web 管理ツールにログインします。

ユーザ名に、”admin”を入力します。

パスワードに、”adminadmin”を入力します。

Web 管理ツールの URL は、

http://<ホスト名>:<ポート番号

>/bpeladmin/index.html

です。

メニュー[プロセス定義]を選択して、プロセス

定義一覧を表示します。

次に、[新規登録]をクリックします。

[参照]をクリックして BPAR ファイルを選択し

ます。プロセス定義名には、自動で

“sample”と入ります。

登録ボタンをクリックします。

BPAR ファイルは

WebOTX Process

Conductor に登

録するための

BPEL プロセスフ

ァイルや WSDL フ

ァイルを ZIP 形

式で圧縮したも

のです。

39

登録が完了すると右図のように登録成功の

メッセージが表示されます。

以上で登録は完了です。

40

1.6.3.サンプルの実行と結果確認

本サンプルで使用しているクライアントアプリケーションは、文字列データを WebOTX Process Conductor が提

供するサービスに送信し、結果を得るというものです。

クライアントアプリケーションをビルドします。ビルドは、<WebOTX AS のインストールディレク

トリ>/ProcessConductor/sample/client/build.sh を実行します。

Ex)

root> cd /opt/WebOTX/ProcessConductor/sample/client/ root> ./build.sh

クライアントアプリケーションの実行します。実行は、<WebOTX AS のインストールディレクトリ

>/ProcessConductor/sample/client/run.bat を実行します。

Ex)

root> cd /opt/WebOTX/ProcessConductor/sample/client/ root> ./run.sh

結果確認

クライアントアプリケーションは正常終了すると、以下のようなメッセージが標準出力に出力さ

れます。

Buildfile: build.xml

run:

[java]<datacenterRequest xmlns="urn:bpelService"> testdata</datacenterRequest>

( ７１ )

BUILD SUCCESSFUL

実行結果は、Web 管理ツールでも確認することができます。

Web 管理ツールにログインしま

す。

WebOTX AS がインス

トールされている

パスによっては、コ

ンパイルに失敗す

ることがあります。

この場合、sample

ディレクトリをド

ライブ直下などに

コピーの上でビル

ド/実行して下さ

い。

41

メニュー[送受信ログ参照]を選択

します。

サンプルが正常終了した場合は、

一度の実行で送信ログと受信ロ

グがそれぞれ１つずつ表示されま

す。

42

1.6.4.サンプルの設定解除

サンプルをアンインストールするには、WebOTX Process Conductor に登録されたプロセス定義の

削除と、サンプルの外部 Web サービスの配備解除を行います。サンプルのアンインストール処理

は、WebOTX Process Conductor のアンインストール時にも自動で実行されます。

1. プロセス定義の削除

Web 管理ツールにログインします。

メニュー[プロセス定義]を選択して、プ

ロセス定義一覧を表示します。

次に、プロセス定義名“sample”を選択

して[参照]をクリックします。

[削除]をクリックします。

43

右のダイアログが表示されます。

「ＯＫ」をクリックします。

削除が完了すると右図が表示されま

す。

これで WebOTX Process Conductor 内

のプロセス定義を完全に削除すること

ができました。

2. 外部 Web サービスの配備解除

次にサンプルの外部 Web サービスの配備解除手順を説明します。

otxadmin で以下のコマンドを実行します。

undeploy --user <admin_user> --password <admin_password> --port <port_number>

sampleService


Ex)

otxadmin>undeploy --user admin --password adminadmin --port 6212 sampleService

Documents

セットアップガイド - NEC(Japan)...¾ Oracle Database 10g Release1 (10.1.0) ¾ Oracle Database 10g Release2 (10.2.0) ¾ Oracle Database 11g Release1 (11.1.0) ¾ MySQL Enterprise