| 1. インストール/アンインストール |
WebOTXをセットアップする際の注意事項について説明します。
| 1.1. Windows版 |
インストールを実行するために必要な Windows インストーラ のバージョン
WebOTX Application Server Standard/Enterprise Edition のインストールを行うには、
Windows インストーラ 3.1以上がマシンにインストールされている
必要があります。
Windows インストーラ 3.1 がマシンにインストールされていない場合には、
WebOTX Application Server Standard/Enterprise Edition のインストール時に、自動的に
インストールされます。
コンピュータの再起動
WebOTXのインストール後、運用を行う前に必ずコンピュータの
再起動を行ってください。
コンピュータを再起動しないと、WebOTXは正常に動作しません。
追加／変更インストール
すでにインストール済みの環境の機能を追加／変更する場合には、
WebOTX メディアからインストーラを起動してください。
アンインストール
アンインストール時に「定義情報の削除」を選択した場合でも、 インストールフォルダにディレクトリやファイルが残る場合があります。 アンインストール完了後、すべて削除してください。
各 WebOTX 製品 の複数混在環境
各 WebOTX 製品のインストールにおいて、既に他の WebOTX 製品がインストール
されている場合、「インストール先フォルダ」には同じフォルダを指定してください。
また、各 WebOTX 製品のアンインストールにおいて、複数のWebOTX製品が
インストールされている環境から、一つの WebOTX 製品のみのアンインストールを実施する
場合には「定義情報の削除」オプションを選択しないでください。
Developer(テスト用サーバ)がサポートするWebサーバ
WebOTX Developer(with Developer's Studio)でインストールする
「テスト用サーバ」機能を利用する場合、外部Webサーバ
(IIS、WebOTX Webサーバ、Apache HTTP Server、Sun ONE Web Server)
と連携動作することはできません。
「テスト用サーバ」機能がインストールする「Javaベースの内部Webサーバ」を利用
してください。
Developer(テスト用サーバ)の自動起動設定
WebOTX Developer(with Developer's Studio)でインストールする
「テスト用サーバ」機能は、マシン起動とともに動作するサービスプログラム
として登録されます。
自動起動を止める場合には、「コントロールパネル」-「サービス」マネージャから
「WebOTX AS Agent Service」を選択して「スタートアップの種類」を「手動」に
変更してください。
Developer(テスト用サーバ)とWebOTXの各 Edition 製品のインストール
WebOTX Developer(with Developer's Studio)のインストール時に選択できる
「テスト用サーバ」機能は、WebOTX Application Server の各Edition製品
(「WebOTX Application Server Web Edition」、「WebOTX Application Server Standard-J Edition」、「WebOTX Application Server Standard Edition」
および「WebOTX Application Server Enterprise Edition」)と同一の環境にインストールすることはできません。
すでに「テスト用サーバ」機能がインストールされている環境に、WebOTX Application Server の各Edition製品を
インストールする場合には、次のどちらかの手順に従ってインストール
を実施してください。
テスト用サーバのアンインストール
「WebOTX Developer(with Developer's Studio)」のインストーラを起動して「テスト用サーバ」機能を削除します。
その後、WebOTX Application Server の各Edition製品のインストールを実行してください。
ライセンスの追加 (WebOTX Application Server Standard-J Edition の場合のみ有効)
「テスト用サーバ」がインストールされている環境で、次のライセンス追加用コマンドを実行し、「WebOTX Application Server Standard-J Edition」のライセンスを追加してください。
>${INSTALL_ROOT}\share\bin\otxladd.exe
なお、アンインストール時には、次のライセンス削除コマンドを実行し、事前に「WebOTX Application Server Standard-J Edition」のライセンスを削除する必要があります。
>${INSTALL_ROOT}\share\bin\otxldel.exe 2
WebOTX UDDI Registry と WebOTX Application Server の各 Edition 製品のインストール
WebOTX UDDI Registry と WebOTX Application Server の各Edition製品を同一環境にインストールする場合、
それぞれのインストーラでインストール時に選択する機能は、同じ機能を選択してください。
例えば、WebOTX UDDI Registry と WebOTX Application Server Standard Editionを同一環境にインストールする
場合において、WebOTX UDDI Registry のインストール時に「Webサーバ 1.3」の機能を選択した
場合には、WebOTX Application Server Standard Editon のインストール時にも「Webサーバ 1.3」の機能を選択して
ください。
また、インストール時に設定するポート番号等の設定値も、同一の値を設定してください。
すでに WebOTX UDDI Registry をインストールしている環境に、WebOTX の各Edition製品をインストール
する場合、インストール前に WebOTX UDDI Registry のインストールで作成したドメインは削除してください。
>${INSTALL_ROOT}\ant_setup.bat uninstall
WebOTX ClusterとWebOTXの各 Edition 製品のインストール
すでに WebOTX Clusterをインストールしている環境に、WebOTX の各Edition製品をインストールする
場合、インストール前に WebOTX Clusterのインストールで作成したドメインは削除してください。
>${INSTALL_ROOT}\ant_setup.bat uninstall
WebOTX Media(64Bit) for x64 に収録される32ビット版インストーラ
WebOTX Media(64Bit) for x64 に収録されている 3枚目,4枚目のメディアには、
Windows(32ビットOS)用の次の製品のインストーラが格納されています。32ビットOS上
でのアプリケーション開発や、32ビットOSから運用管理ツール／クライアント
アプリケーションの接続に利用できます。
WebOTX Client(Windows版)のインストール
UNIX(HP-UX(IPF)/Linux(x86/x64))の各WebOTX メディア には、Windows版のWebOTX
クライアントのインストーラが格納されています。
利用するWindows OS(x86/x64)と実行するWebOTXのクライアントアプリケーション
(32ビット/64ビット)により、インストールするWindows版クライアント物件が異なりますので
注意してください。
| Windows (x86/x64) | クライアント アプリケーション (32ビット/64ビット) |
インストールするクライアント物件 |
|---|---|---|
| Windows (x86) | 32ビット | /CLIENT/WIN/setup.exe |
| Windows (x64) | 32ビット | /CLIENT/WIN/setup.exe |
| 64ビット | /CLIENT/WIN_x64/setup.exe |
ローカルセキュリティポリシーの設定
「ローカルセキュリティポリシー」の設定によっては、インストール時に
「ソースファイルが見つかりません。:<CD-ROMドライブ>\フォルダ\Data1.cab。
ファイルが存在するかどうか、およびこのファイルのアクセス権があるか
どうかを確認してください。」のメッセージが出力され、インストールが失敗する場合
があります。
次のローカルセキュリティポリシーを確認してください。
「ローカルセキュリティポリシー」−「セキュリティオプション」において、
「CD-ROM へのアクセスを、ローカルログオンユーザだけに制限する」の設定を
確認し、「有効」に設定されている場合は「無効」に変更してください。
Windowsの一時ポートとWebOTXで利用するポート
Windowsの既定値では、TCPポート1024-5000を一時ポートとして使用します。
しかしWebOTXが既定値で使用するポートとして、2809番(Object Brokerの名前サーバ)と4848番(Webコンテナ管理用)があり、
場合によってはポートの競合が発生しアプリケーションが正常に動作しなくなることがあります。
これらのポートをWindowsの一時ポートとして利用しないようにするためには、レジストリに以下の設定を行なってください。
レジストリの HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters配下に以下の項目を追加します。
名前：ReservedPorts
種類：REG_MULTI_SZ
値：以下を2行で入力してください
2809-2809
4848-4848
設定変更後はマシンの再起動が必要です。
Windows2003 マシンに Webサーバ1.3をインストールした場合
Windows2003 マシンにおいて、インストール時に「Webサーバ 1.3」を
選択した場合、インストール／新規ドメイン作成の途中で、イベントログ
情報とWebOTXのログ情報に、次の警告／エラーメッセージが出力される場合があります。
WebOTX では、ドメインの作成時に情報設定のために、ドメイン作成と
同時にそのドメイン自体の起動を行いますが、Webサーバのサービス
起動は行わないために、ドメイン停止時に「Webサーバのサービスは
起動していない」という意味の次の各メッセージが出力されます。
本メッセージが出力されても動作上特に問題はありません。
警告メッセージ(イベントログ)
OTX05230002: コマンドの実行(execute)で例外(ExecException)が発生しました。 (com.nec.webotx.enterprise.system.webserver) Error: com.nec.webotx.enterprise.util.ExecException: abnormal subprocess termination: Detailed Message:The Process Output: The WebOTX WebServer domain1 service is not started.
OTX01205061: 例外 : (com.nec.webotx.enterprise.system.core) Error: com.nec.webotx.appserv.server.ServerLifecycleException: com.nec.webotx.enterprise.util.ExecException: abnormal subprocess termination: Detailed Message:The Process Output: The WebOTX WebServer domain1 service is not started.
OTX01205107: サービス "WebServerService" を停止することができません！ (com.nec.webotx.enterprise.system.core).
エラーメッセージ(イベントログ)
OTX05210004:WebServer Lifecycle Shutdown で例外が発生しました。
(com.nec.webotx.enterprise.system.webserver) Error:
com.nec.webotx.enterprise.webserver.WebServerRuntimeException:
com.nec.webotx.enterprise.util.ExecException: abnormal subprocess
termination: Detailed Message:The Process Output:
The WebOTX WebServer domain1 service is not started.
| 1.2. WindowsXP SP2対応 |
Windows XP サービスパック2では、標準実装されている「Windowsファイアウォール」機能がデフォルトで有効になっています。
Windowsファイアウォールの設定で[例外]タブを使用して、次のプログラムやポートの例外設定を行なってください。
名前:java.exe
名前:javaw.exe
名前:java.exe
名前:javaw.exe
| 1.3. Windows2003 SP1/R2 対応 |
Windows 2003 サービスパック1 以降および Windows 2003 R2 環境では、
「Windowsファイアウォール」機能が標準実装され、デフォルトは「無効」となっていますが、
「有効」に設定した場合WebOTXの動作に影響があります。
Windowsファイアウォールの設定で[例外]タブを使用して、次のプログラムやポートの例外設定を行なってください。
| 製品名、および機能 | プログラム名 | 備考 |
|---|---|---|
| 全Edition共通 実行基盤 |
<JAVA_HOME>\jre\bin\javaw.exe | |
| <WebOTX_Dir>\ObjectBroker\bin\Namesv.exe | ||
| <WebOTX_Dir>\ObjectBroker\bin\oad.exe | ||
| Object Broker | <WebOTX_Dir>\ObjectBroker\bin\corbaloc.exe | corbalocサーバ利用時 |
| <WebOTX_Dir>\ObjectBroker\bin\irsv.exe | IRサーバ利用時 | |
| Object Broker Java | <JAVA_HOME>\bin\java.exe | |
| JMS | <JAVA_HOME>\bin\java.exe | |
| Standard/Enterprise Edition 実行基盤 |
<WebOTX_Dir>\Trnsv\bin\iioplsn.exe | |
| <WebOTX_Dir>\Trnsv\bin\iiopAsync.exe | ||
| <WebOTX_Dir>\Trnsv\bin\olftplsn.exe | ||
| <WebOTX_Dir>\Trnsv\bin\tpadmd.exe | ||
| Enterprise Edition/Cluster (WatchServer) |
<WebOTX_Dir>\WOWS\bin\WatchServer.exe | |
| Enterprise Edition/Cluster (CNS) |
<WebOTX_Dir>\ObjectBroker\bin\cnamesv.exe | |
| WebOTX Developer (for CORBA Application) |
<WebOTX_Dir>\dev\bin\nSvSimc.exe | C++の場合 |
| <JAVA_HOME>\bin\java.exe | Javaの場合 | |
| Transaction サービス | <JAVA_HOME>\bin\java.exe | CORBAを利用し、かつクライアント側でトランザクションを開始する場合 |
| Webサービス | Webサーバ および Webコンテナ の設定を参照してください。 | |
| WebOTX Webサーバ (Apache1.3/2.0) |
<WebOTX_Dir>\WebServer\apache.exe | Apache 1.3 利用の場合 |
| <WebOTX_Dir>\WebServer2\bin\apache.exe | Apache 2.0 利用の場合 | |
| Download Server | ダウンローダ管理ツールを使用する場合、全Edition共通実行基盤の内容に加えて、右のプログラムについて例外設定を行ってください。 |
FTPサーバ ASP配備サービス |
| 製品名、および機能 | 名前 | ポート | プロトコル | 備考 |
|---|---|---|---|---|
| 全Edition共通 実行基盤 |
任意 | 6212 6202 |
TCP | |
| Object Broker | oad | 9825 | TCP | |
| Namesv | 2809 | TCP | ||
| corbaloc | 9827 | TCP | corbalocサーバ利用時 | |
| irsv | 9830 | TCP | IRサーバ利用時 | |
| Object Broker Java | 任意 | 9826 | TCP | |
| Standard/Enterprise Edition 実行基盤 |
tpadmd | 8892 | TCP | |
| Enterprise Edition/Cluster (WatchServer) |
WatchServer | 5190 | TCP | |
| Enterprise Edition/Cluster (CNS) |
cnamesv | 9829 | TCP | |
| JMS | 任意 | 9700 | TCP | |
| Transaction サービス | ProxyRCS | 5970 | TCP | CORBAを使用し、かつクライアント側でトランザクションを開始する場合 |
| Webコンテナ | 管理用 | 4848 | TCP | |
| HTTP | 80 | TCP | 内蔵Webサーバを利用する場合 | |
| HTTPS | 443 | TCP | ||
| Webサーバ連携 | 8009 | TCP | 別マシンの外部Webサーバを利用する場合 | |
| WebOTX Webサーバ (Apache1.3/2.0) |
HTTP | 80 | TCP | |
| HTTPS | 443 | TCP | ||
| WebAP JSP (ファイル転送機能) |
任意 | (*) | TCP | (*)ファイル転送用に任意に設定したポート番号 |
| OLF/TP Adapter (着信接続機能) |
任意 | (*) | TCP | (*)通信環境定義(OLFAdapter.ini)のUTPort(あるいはUWPort)プロパティで指定した着信用ポート番号 |
| 1.4. UNIX版 |