2. インストール

本章では、WebOTX製品のインストール方法について説明します。

バックアップ環境のリストアに関しては、 [ 高度な管理と運用サイクルガイド > 1. バックアップ/リストア > 1.3. 同一環境にリストアする手順 ] あるいは [ 高度な管理と運用サイクルガイド > 1. バックアップ/リストア > 1.4. 異なる環境にリストアする手順 ] を参照してください。

以下からの説明では、WebOTX Application Serverの各エディション(Express、Standard、Enterprise)を「WebOTX AS」と省略して表現します。

[WebOTX Mediaの収録製品一覧]

WebOTX 製品のインストールには利用するプラットフォームに対応するWebOTX Mediaが最低1つ必要になります。複数のマシンにインストールする場合、WebOTX Mediaは複数マシン間で共有することが可能です。
WebOTX Mediaは出荷時期及び対応プラットフォームにより収録製品が異なります。
以下にWebOTX Media V9 Release 7の収録製品一覧を記載します。

表1
対応プラットフォーム WebOTX Mediaの製品名 型番 備考
Windows (x86) WebOTX Media V9 Release 7(DVD) UL1519-U1T
Windows (x64) WebOTX Media (x64) V9 Release 7(DVD) UL1519-G1S
Linux (x86) - - V9.4ではサポートされません。
Linux (x64) WebOTX Media (x64) V9 Release 7(DVD) UL4021-G1T
HP-UX (IPF) WebOTX Media (IPF) V9 Release 7(DVD) UQ2621-AJ0B1

2.1. インストール前の作業

インストール前に必ず行う必要がある作業と確認事項について、それぞれのOSごとに説明します。

ここからは、OSごとに固有の作業内容を説明していきます。

2.1.1. Windows

WebOTXをインストールする前に次の作業を行います。

WebOTX製品は、新旧の複数バージョンのインストールと、同一バージョンの複数位置へのインストールはできません。 したがって、既に旧バージョンのWebOTXか本バージョンのWebOTXがインストールされている場合は、WebOTXのサービス群を停止した後にアンインストールを行なってください。 操作手順については、ご利用になっているバージョンのマニュアルをご参照ください。

インストール作業は、必ずAdministratorsグループに所属した管理者権限があるユーザで行わなければなりません。 管理者権限があるユーザでログインしていることを確認してください。
インストールを行う場合は、Built-in Administratorユーザで行うか、管理者権限のあるユーザでも「管理者として実行」 によりインストーラを起動してください。

Windows版のインストーラはレジストリへの書き込みを行います。以下のレジストリキーに SYSTEMユーザおよびAdministratorsグループの書き込み権限が設定されていることを確認してください。

HKEY_LOCAL_MACHINE\SOFTWARE\NEC (*1)
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\NEC (*1,*2)
*1
存在しない場合は上位のレジストリキーに権限が設定されていることを確認してください。
*2
64bit版Windowsにインストールする場合のみ確認してください。

この作業が完了したら[ 2.2. インストール ]に進んでください。

2.1.2. HP-UX、Linux

製品をインストールする前に次の作業を行います。


V9からインストールスクリプトによる製品インストール時に、WebOTX Utility (OTX94UTIL) は自動的にインストールされ、製品ライセンスを一つ登録することが可能になりましたので、事前にインストールする必要はありません。[ 2.2. インストール ] に進んでください。ライセンス追加登録は [ 2.4. 製品ライセンスの追加登録 > 2.4.1. WebOTX ASのライセンス体系 ]を参照し、インストール完了後に行ってください。
また、複数バージョンインストール対応に伴い、インストールスクリプトでWebOTX Utilityのインストール先を以下の通り切り替えます。

2.1.3. Dockerの環境構築

Dockerのコンテナ内でWebOTX ASを動作させる場合は、事前にDockerの環境構築を行う必要があります。 Dockerの環境構築を行うため、ホストOSで以下の作業を実施してください。

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

    login: root
  2. Redhat Netrowkのextraチャネルを有効化します。 次のコマンドを実行します。

    root> subscription-manager repos --enable=rhel-7-server-extras-rpms
  3. Dockerをインストールします。 次のコマンドを実行します。

    root> yum install docker
  4. コンテナイメージを作成する際にRedhat Networkへのアクセスが発生するため、必要であればDockerに対してプロキシサーバの設定を行います。 まず、systemdが利用するDockerの設定ファイルの配置場所を作成します。

    root> mkdir /etc/systemd/system/docker.service.d

    次に、環境変数HTTP_PROXYと環境変数NO_PROXYをDockerに対して設定するために、以下の内容で/etc/systemd/system/docker.service.d/http-proxy.confを作成します。

    [Service]
    Environment="HTTP_PROXY=http://[プロキシサーバ]:[ポート番号]/" "NO_PROXY=[除外対象],/var/run/docker.sock"
    

    http-proxy.confの具体例を以下に示します。

    [Service]
    Environment="HTTP_PROXY=http://proxy.example.com:8080/" "NO_PROXY=localhost,127.0.0.0/8,::1,/var/run/docker.sock"
    

    また、rootユーザに対しても同様の環境変数を設定します。

  5. ファイアウォールを無効化します。 本マニュアル執筆時点では、RHEL 7.1にインストール済みのファイアフォールが有効化されていると正常動作しません。 詳細については、Red Hat社の以下の報告を参照してください。 https://bugzilla.redhat.com/show_bug.cgi?id=1098281

    ファイアウォールを無効化するには、次のコマンドを実行します。

    root> systemctl stop firewalld.service
    root> systemctl disable firewalld.service
    
  6. Dockerのサービスを有効化します。次のコマンドを実行します。

    root> systemctl start docker.service
    root> systemctl enable docker.service
    

2.2. インストール

WebOTX製品をインストールする手順について各々のOSごとに説明します。

2.2.1. Windows

ここでは、下に示したWindows用のWebOTX製品および添付品について、それぞれのインストール方法を説明します。

製品のインストーラで登録可能なライセンスは一つです。そのため、ライセンスの追加登録はライセンス登録コマンドにより行います。 また、インストール後にCPU割当追加などシステム環境を変更する場合、ライセンスの追加登録が必要となるケースがあります。 ライセンス登録コマンドの使用方法については、[ 2.4. 製品ライセンスの追加登録 > 2.4.2. Windows ]を参照してください。

Caution
WebOTX AS Express/Standard/Enterprise V9.4から登録されているライセンス数が不足している場合、ドメイン起動時に以下のようなWARNINGメッセージが${INSTANCE_ROOT}/logs/webotx_agent.logに出力されます。
WARNINGメッセージが出力される場合、[ 2.4. 製品ライセンスの追加登録 > 2.4.2. Windows ]を参照してライセンスの追加登録を行ってください。
OTX01130084: The number of registered licenses is * fewer than it is required. The system has * processors, but * license(s) is/are registered. Product Name: WebOTX Application Server Express/Standard/Enterprise V*.*

OTX01130084: ライセンス登録数が * 不足しています。CPUコア数 * に対して登録数が * です。製品名: WebOTX Application Server Express/Standard/Enterprise V*.*
"*"には環境に応じた数字、もしくは製品のバージョンが出力されます。

2.2.1.1. WebOTX Application Server Express

  1. WebOTXメディアのDVD媒体をDVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Application Server Express V9.4] を選び、「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.1-1

    memo
    Windows Server 2012 / Windows Server 2012 R2 Server Core にインストールする場合は コマンドプロンプトより wo_setup.exe を実行してください。
    インストール作業はGUIで操作可能です。
  2. Windowsインストーラが起動し「インストールの準備中」というメッセージ が表示されたあとに次の画面が表示されます。 「次へ」ボタンを押してください。

    Expressインストーラ開始画面
    図2.2.1.1-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面

    図2.2.1.1-3

  4. [インストール先のフォルダ] 画面が表示されるのでインストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」 ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.1-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ画面
    図2.2.1.1-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.1-1
    アイコン 説明
    Webサーバ WebOTX Webサーバをインストールします。 既定値ではインストールされません。 (*1)、(*2)
      Webサーバ 2.2 Webサーバ(Apache HTTP Server 2.2.31 ベース)をインストールします。
      Webサーバ 2.4 Webサーバ(Apache HTTP Server 2.4.18 ベース)をインストールします。
    *1
    WebOTX内蔵型のJavaベースのWebサーバを使用する場合や、外部のWebサーバ、例えば、Microsoft Internet Information Services (IIS)などと連携動作させる場合には、インストーラから「WebOTXサーバ」選択する必要はありません。 IIS 等の外部 Web サーバを利用する場合は、インストール後の作業で「Webサーバとの動作連携設定」を行う必要があります。
    *2
    「Webサーバ」を選択した場合は、「Webサーバ2.2」または、「Webサーバ2.4」どちらかの選択が必要となります。
  6. [インストール済みの JDK] 画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、複数のJDK がインストールされている場合、最後にインストールした JDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。
    ※Windows(x86)プラットフォームの場合は32bit版のJDK、Windows(x64)プラットフォームの場合は64bit版のJDKがインストールされているフォルダを指定してください。それ以外のフォルダが指定されている場合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。

    インストール済のJDK
    図2.2.1.1-6

  7. [ユーザドメインの作成]画面が表示されますので、ユーザドメインの作成有無を設定後、「次へ」ボタンを押してください。
    デフォルトでは、運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。

    ユーザドメインの作成
    図2.2.1.1-7


    表2.2.1.1-2
    設定項目 説明
    運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成 運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。ユーザドメインの情報(ユーザドメイン名、HTTP/HTTPS ポート番号)は、次の画面で入力します。
    運用管理ドメイン(WebOTXAdmin)のみ作成 運用管理ドメイン(WebOTXAdmin)のみを作成します。利用者は、インストール完了後に、otxadmin.bat コマンドを実行して、任意の名前のユーザドメインを作成します。

  8. 「運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成」を選択した場合、[ユーザドメインの設定]画面が表示されますので、ユーザドメイン情報(ユーザドメイン名、HTTPポート番号、HTTPSポート番号)を設定後、「次へ」ボタンを押してください。

    ユーザドメインの設定
    図2.2.1.1-8


    表2.2.1.1-3
    設定項目 説明
    ユーザドメイン名 ユーザドメイン名を指定します。デフォルト値は、domain1 です。ユーザドメイン名には、半角英数字と、ハイフン(-)、アンダーバー(_)を32文字以内で指定します。
    HTTP ポート番号 ユーザドメインで利用する HTTPポート番号を指定します。デフォルト値は 80 です。他製品が利用しているポート番号と重複して設定することはできません。
    HTTPS ポート番号 ユーザドメインで利用する HTTPS ポート番号を指定します。デフォルト値は 443 です。他製品が利用しているポート番号と重複して設定することはできません。

  9. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図2.2.1.1-9

  10. [WebOTX Application Server Express をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中の画面
    図2.2.1.1-10

  11. ファイルのコピーが終わると、WebOTX の初期ドメイン環境(WebOTXAdmin、ユーザドメイン)を設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。初期ドメイン環境の設定結果は${AS_INSTALL}\ant_setup.log で確認できます。

    ant_setup.bat 起動画面
    図2.2.1.1-11

  12. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。

    インストール終了画面
    図2.2.1.1-12



  13. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.2. WebOTX Application Server Standard

  1. WebOTXメディアのDVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Application Server Standard V9.4] を選び 「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.2-1

    memo
    Windows Server 2012 / Windows Server 2012 R2 Server Core にインストールする場合は コマンドプロンプトより wo_setup.exe を実行してください。
    インストール作業はGUIで操作可能です。
  2. Windowsインストーラが起動し「インストールの準備中」というメッセージ が表示されたあとに次の画面が表示されます。 「次へ」ボタンを押してください。

    Standard インストーラ開始画面
    図2.2.1.2-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面
    図2.2.1.2-3

  4. [インストール先のフォルダ] 画面が表示されるのでインストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.2-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ
    図2.2.1.2-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.2-1
    アイコン 説明
    アプリケーションサーバ環境 アプリケーションサーバ環境をインストールします。
    次の選択アイコンから[TPモニタ] および [Transaction Service]を選択することができます。
      TPモニタ TPモニタ機能をインストールします。この機能は必ずインストールされます。
      IIOP Over SSL TPモニタ上で動作するIIOPリスナの通信をSSLで暗号化を行う場合にインストールします。
    Transaction Service Transaction Service 実行環境をインストールします。この機能は必ずインストールされます。
    Webサーバ WebOTX Webサーバをインストールします。(*1) (*2)
      Webサーバ 2.2 Webサーバ(Apache HTTP Server 2.2.31 ベース)をインストールします。
      Webサーバ 2.4 Webサーバ(Apache HTTP Server 2.4.18 ベース)をインストールします。
    拡張機能 オプションの拡張機能をインストールします。 既定値ではインストールされません。
    次の選択アイコンからオプションの拡張機能を選択できます。
      画面テンプレートプラグイン 画面テンプレートのWebサーバ用のプラグインモジュールをインストールします。画面テンプレートは、Webブラウザからの入力情報をWebサーバを通してWebOTXへ渡し、HTTPパラメータの制御やHTML画面生成をWebOTXサーバ上の Javaプログラム(サーバAP)で行う機能を提供します。
    *1
    WebOTX内蔵型のJavaベースのWebサーバを使用する場合や、外部のWebサーバ、例えば、Microsoft Internet Information Services (IIS)などと連携動作させる場合には、インストーラから「WebOTXサーバ」選択する必要はありません。IIS等の外部 Web サーバを利用する場合は、インストール後の作業で「Webサーバとの動作連携設定」を行う必要があります。
    *2
    V9.4からデフォルトでインストールするWebサーバはWebサーバ 2.4になりました。
  6. [インストール済みの JDK] 画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、マシンに複数バージョンのJDKがインストールされている場合、最後にインストールした JDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。
    ※Windows(x86)プラットフォームの場合は32bit版のJDK、Windows(x64)プラットフォームの場合は64bit版のJDKがインストールされているフォルダを指定してください。それ以外のフォルダが指定されている場合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。

    インストール済みの JDK
    図2.2.1.2-6

  7. [ユーザドメインの作成]画面が表示されますので、ユーザドメインの作成有無を設定後、「次へ」ボタンを押してください。
    デフォルトでは、運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。

    ユーザドメインの作成
    図2.2.1.2-7


    表2.2.1.2-2
    設定項目 説明
    運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成 運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。ユーザドメインの情報(ユーザドメイン名、HTTP/HTTPS ポート番号)は、次の画面で入力します。
    運用管理ドメイン(WebOTXAdmin)のみ作成 運用管理ドメイン(WebOTXAdmin)のみを作成します。利用者は、インストール完了後に、otxadmin.bat コマンドを実行して、任意の名前のユーザドメインを作成します。

  8. [Webコンテナの動作モード設定] 画面が表示されるのでWebコンテナの動作モードを指定し、「次へ」ボタンを押してください。

    アドバンスドモードを選択すると、WebコンテナはTPモニタの制御下で動作します。高信頼、高可用なシステムを構築する際に選択します。

    スタンダードモードを選択すると、Webコンテナはドメイン・エージェント内で動作します。高性能なシステム構築を行う際に選択します。

    なお、アドバンスドモードを選択した場合には、「WebOTX Webサーバ」を同時にインストールするか、マシン上に「Apache HTTP Server」または「Microsoft Internet Information Services (IIS)」がインストールされている必要があります。
    また、Javaベースの内蔵Webサーバを利用する場合は、スタンダードモードを選択してください。


    Webコンテナの動作モード設定画面
    図2.2.1.2-8

  9. [Webコンテナの動作モード設定] 画面でアドバンスドモードを選択した場合、[WebコンテナとWebサーバの連携モード設定] 画面が表示されます。 WebサーバとWebコンテナ間の通信に利用するプロトコルを選択し、「次へ」ボタンを押してください。

    IISとWebコンテナを連携する場合や、WebサーバをAPサーバとは別のマシンに配置し、APサーバをクラスタ化して負荷分散を行う場合には「AJPプロトコル」を選択してください。

    WebサーバとWebコンテナ間のTCPコネクションを多重化して有効利用する場合や、WebOTX AS V9.2以前と同様の構成をとる場合には「IIOPプロトコル」を選択してください。

    WebコンテナとWebサーバの連携モード設定画面
    図2.2.1.2-9

  10. 「運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成」を選択した場合、[ユーザドメインの設定]画面が表示されますので、ユーザドメイン情報(ユーザドメイン名、HTTPポート番号、HTTPSポート番号)を設定後、「次へ」ボタンを押してください。

    ユーザドメインの設定画面
    図2.2.1.2-9


    表2.2.1.2-3
    設定項目 説明
    ユーザドメイン名 ユーザドメイン名を指定します。デフォルト値は、domain1 です。ユーザドメイン名には、半角英数字と、ハイフン(-)、アンダーバー(_)を32文字以内で指定します。
    HTTP ポート番号 ユーザドメインで利用する HTTPポート番号を指定します。デフォルト値は 80 です。他製品が利用しているポート番号と重複して設定することはできません。
    HTTPS ポート番号 ユーザドメインで利用する HTTPS ポート番号を指定します。デフォルト値は 443 です。他製品が利用しているポート番号と重複して設定することはできません。

  11. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    プログラムをインストールする準備ができました画面
    図2.2.1.2-10

  12. [WebOTX Application Server Standard をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストールしています画面
    図2.2.1.2-12

  13. ファイルのコピーが終わると、WebOTX の初期ドメイン環境(WebOTXAdmin、domain1)を Apache Ant コマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は${AS_INSTALL}\ant_setup.log で確認できます。

    ant_setup.bat 起動画面
    図2.2.1.2-13

  14. 「拡張機能」で「画面テンプレートプラグイン」を選択している場合、[画面テンプレートプラグインモジュールの環境設定] 画面が表示されます。インストール完了後、画面テンプレートプラグインモジュールの環境設定を行ってください。 「次へ」ボタンを押してください。

    画面テンプレート画面
    図2.2.1.2-15

  15. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。

    インストール終了画面
    図2.2.1.2-16

  16. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.3. WebOTX Application Server Enterprise

WebOTX Application Server Enterpriseは、通常のAPサーバとしての機能のインストールとは別に、旧製品のWebOTX Cluster製品相当の機能のみインストールすることが可能です。本章では、通常のAPサーバとしての機能をインストールする場合の手順を説明します。

Caution
WebOTX AS Enterpriseのインストール完了後にインストールパターン(WebOTX AS Enterpirse全機能インストール/クラスタ機能のみインストール)を変更することはできません。インストールパターンを変更する場合は、再インストールが必要となります。

  1. WebOTXメディアのDVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Application Server Enterprise V9.4] を選び、「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.3-1

    memo
    Windows Server 2012 / Windows Server 2012 R2 Server Core にインストールする場合は コマンドプロンプトより wo_setup.exe を実行してください。
    インストール作業はGUIで操作可能です。
  2. Windowsインストーラが起動し「インストールの準備中」というメッセージ が表示されたあとに次の画面が表示されます。 「WebOTX Application Server Enterpriseをインストールします。」を選択し、「次へ」ボタンを押してください。

    Enterprise インストーラ開始画面
    図2.2.1.3-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面
    図2.2.1.3-3

  4. [インストール先のフォルダ] 画面が表示されるのでインストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」 ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.3-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ
    図2.2.1.3-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.3-1
    アイコン 説明
    アプリケーションサーバ環境 アプリケーションサーバ環境をインストールします。
    次の選択アイコンから[TPモニタ] および [Transaction Service]を選択することができます。
      TPモニタ TPモニタ機能をインストールします。この機能は必ずインストールされます。
      IIOP Over SSL TPモニタ上で動作するIIOPリスナの通信をSSLで暗号化を行う場合にインストールします。
    Transaction Service Transaction Service 実行環境をインストールします。この機能は必ずインストールされます。
    分散管理機能 ドメインの分散管理に必要な機能をインストールします。
    ※クラスタドメイン(*2)を作成する場合、選択します。
      分散管理サーバ 分散管理サーバは、分散配置されたサーバ上のドメイン群をグルーピングし、個々のドメインへのアプリケーション配備や設定作業を一元化する運用基盤を提供します。この機能をインストールする場合、「Working Domain Coordnator」もインストールされます。
    Working Domain Coordinator Working Domain Coordinatorは、負荷分散装置の利用を前提として構築された複数のサーバを効率よく 利用するために、業務アプリケーションの負荷に応じて、処理を行うサーバの数を調節する機能を提供します。
    Webサーバ WebOTX Webサーバをインストールします。(*1) (*2)
      Webサーバ 2.2 Webサーバ(Apache HTTP Server 2.2.31 ベース)をインストールします。
      Webサーバ 2.4 Webサーバ(Apache HTTP Server 2.4.18 ベース)をインストールします。
    拡張機能 オプションの拡張機能をインストールします。 既定値ではインストールされません。 次の選択アイコンからオプションの拡張機能を選択できます。
      画面テンプレートプラグイン 画面テンプレートのWebサーバ用のプラグインモジュールをインストールします。画面テンプレートは、Webブラウザからの入力情報をWebサーバを通してWebOTXへ渡し、HTTPパラメータの制御やHTML画面生成をWebOTXのプロセスグループ上で動作する CORBAアプリケーションで行う機能を提供します。
    Download Contents Download Contentsは、Webサーバからリッチクライアントアプリケーションを配布する機能を提供します。
    Object Broker CNS Object Broker CNS(キャッシュ名前サーバ)は、複数の名前サーバのキャッシュを構築して信頼性の向上と負荷分散を行います。
    Object Broker Applet Proxy Object Broker Applet ProxyはJavaアプレットとWebサーバ以外で動作するCORBAサーバ間の通信機能を提供します。
    WatchServer WatchServerは、WebOTX ASをマルチサーバの負荷分散構成とした場合に、アプリケーションサーバの監視機能と障害発生時の縮退運転機能を提供します。
    JDBCドライバ(IRS) InfoFrame Relational Store用のJDBCドライバをインストールします。IRSは、複数台のコモディティサーバを使って、1つのデータベースシステムを構成するOLTP(On-LineTransaction Processing)向け分散データベースソフトウェア製品です。
    *1
    WebOTX内蔵型のJavaベースのWebサーバを使用する場合や、外部のWebサーバ、例えば、Microsoft Internet Information Services (IIS)などと連携動作させる場合には、インストーラから「WebOTXサーバ」選択する必要はありません。IIS等の外部 Web サーバを利用する場合は、インストール後の作業で「Webサーバとの動作連携設定」を行う必要があります。
    *2
    V9.4からデフォルトでインストールするWebサーバはWebサーバ 2.4になりました。
    *2
    Working Domain Coordinatorの機能により、業務アプリケーションの負荷に応じて、処理を行うサーバの数を調節することが可能です。(負荷分散装置の利用を前提としています)
  6. [インストール済みの JDK] 画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、複数の JDK がインストールされている場合、最後にインストールした JDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。
    ※Windows(x86)プラットフォームの場合は32bit版のJDK、Windows(x64)プラットフォームの場合は64bit版のJDKがインストールされているフォルダを指定してください。それ以外のフォルダが指定されている場合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。

    インストール済みの JDK
    図2.2.1.3-6

  7. [ユーザドメインの作成]画面が表示されますので、ユーザドメインの作成有無を設定後、「次へ」ボタンを押してください。
    デフォルトでは、運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。

    ユーザドメインの作成画面
    図2.2.1.3-7

    表2.2.1.3-2
    設定項目 説明
    運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成 運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成します。ユーザドメインの情報(ユーザドメイン名、HTTP/HTTPS ポート番号)は、次の画面で入力します。
    運用管理ドメイン(WebOTXAdmin)のみ作成 運用管理ドメイン(WebOTXAdmin)のみを作成します。利用者は、インストール完了後に、otxadmin.bat コマンドを実行して、任意の名前のユーザドメインを作成します。
    クラスタドメインの作成 クラスタドメインを作成します。[カスタムセットアップ] 画面で[クラスタ機能]インストールを選択していない場合、グレーアウト表示となり選択することはできません。
  8. [Webコンテナの動作モード設定] 画面が表示されるのでWebコンテナの動作モードを指定し、「次へ」ボタンを押してください。

    アドバンスドモードを選択すると、WebコンテナはTPモニタの制御下で動作します。高信頼、高可用なシステムを構築する際に選択します。

    スタンダードモードを選択すると、Webコンテナはドメイン・エージェント内で動作します。高性能なシステム構築を行う際に選択します。

    なお、アドバンスドモードを選択した場合には、「WebOTX Webサーバ」を同時にインストールするか、マシン上に「Apache HTTP Server」または「Microsoft Internet Information Services (IIS)」がインストールされている必要があります。
    また、Javaベースの内蔵Webサーバを利用する場合は、スタンダードモードを選択してください。

    Webコンテナの動作モード設定画面
    図2.2.1.3-8

  9. [Webコンテナの動作モード設定] 画面でアドバンスドモードを選択した場合、[WebコンテナとWebサーバの連携モード設定] 画面が表示されます。 WebサーバとWebコンテナ間の通信に利用するプロトコルを選択し、「次へ」ボタンを押してください。

    IISとWebコンテナを連携する場合や、WebサーバをAPサーバとは別のマシンに配置し、APサーバをクラスタ化して負荷分散を行う場合には「AJPプロトコル」を選択してください。

    WebサーバとWebコンテナ間のTCPコネクションを多重化して有効利用する場合や、WebOTX AS V9.2以前と同様の構成をとる場合には「IIOPプロトコル」を選択してください。

    WebコンテナとWebサーバの連携モード設定画面
    図2.2.1.2-9

  10. [ユーザドメインの作成]画面で「運用管理ドメイン(WebOTXAdmin)とユーザドメインを作成」を選択した場合、[ユーザドメインの設定]画面が表示されますので、ユーザドメイン情報(ユーザドメイン名、HTTPポート番号、HTTPSポート番号)を設定後、「次へ」ボタンを押してください。

    ユーザドメインの設定画面
    図2.2.1.3-9


    表2.2.1.3-3
    設定項目 説明
    ユーザドメイン名 ユーザドメイン名を指定します。デフォルト値は、domain1 です。ユーザドメイン名には、半角英数字と、ハイフン(-)、アンダーバー(_)を32文字以内で指定します。
    HTTP ポート番号 ユーザドメインで利用する HTTPポート番号を指定します。デフォルト値は 80 です。他製品が利用しているポート番号と重複して設定することはできません。
    HTTPS ポート番号 ユーザドメインで利用する HTTPS ポート番号を指定します。デフォルト値は 443 です。他製品が利用しているポート番号と重複して設定することはできません。
  11. [カスタムセットアップ]画面で「拡張機能」の「Download Contents」を選択した場合、[Download Contentsのインストール先フォルダ]画面が表示されます。 Download Contents用ファイルの格納フォルダを設定し、「次へ」ボタンを押してください。

    Download Contentsのインストール先フォルダ画面
    図2.2.1.3-10


  12. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図2.2.1.3-12

  13. [WebOTX Application Server Enterprise をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中の画面
    図2.2.1.3-13

  14. ファイルのコピーが終わると、WebOTX の初期ドメイン環境(WebOTXAdmin、ユーザドメイン*1)を Apache Antコマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は${AS_INSTALL}\ant_setup.log で確認できます。

    ant_setup.bat 起動画面
    図2.2.1.3-14

  15. [ユーザドメインの作成]画面で、「クラスタドメインを作成します。」を選択していた場合、クラスタドメインをApache Antコマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は${AS_INSTALL}\ant_setup_cluster.log で確認できます。

    ant_setup_cluster.bat 起動画面
    図2.2.1.3-15

  16. [カスタムセットアップ]画面で「拡張機能」の「画面テンプレートプラグイン」を選択している場合、[画面テンプレートプラグインモジュールの環境設定] 画面が表示されます。インストール完了後、画面テンプレートプラグインモジュールの環境設定を行ってください。 「次へ」ボタンを押してください。

    画面テンプレートプラグイン画面
    図2.2.1.3-16

  17. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。 なお、CORBAアプリケーションをVisual Studio 2015でビルドし、WebOTXで実行するためには、Universal C Runtimeの更新プログラムを適用する必要がある旨のメッセージが出力されます。 Windows(x64)プラットフォームの場合は、[注意制限事項 > 13. TPモニタ > 13.2. 制限事項 > 13.2.6. Microsoft Visual Studio 2015 のランタイムライブラリについて ]もご確認ください。

    インストール終了画面
    図2.2.1.3-16

  18. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.4. WebOTX Application Server Enterprise (クラスタ機能のみインストール)

WebOTX Application Server Enterpriseは、通常のAPサーバとしての機能のインストールとは別に、旧製品のWebOTX Cluster製品相当の機能のみインストールすることが可能です。本章では、クラスタ機能のみインストールする場合の手順を説明します。

Caution
WebOTX AS Enterpriseのインストール完了後にインストールパターン(WebOTX AS Enterpirse全機能インストール/クラスタ機能のみインストール)を変更することはできません。インストールパターンを変更する場合は、再インストールが必要となります。

  1. WebOTXメディアのDVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Application Server Enterprise V9.4] を選び、「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.4-1

    memo
    Windows Server 2012 / Windows Server 2012 R2 Server Core にインストールする場合は コマンドプロンプトより wo_setup.exe を実行してください。
    インストール作業はGUIで操作可能です。
  2. Windowsインストーラが起動し「インストールの準備中」というメッセージ が表示されたあとに次の画面が表示されます。

    「クラスタ機能のみをインストールします。」を選択し、「次へ」ボタンを押してください。

    Enterprise インストーラ開始画面
    図2.2.1.4-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面
    図2.2.1.4-3

  4. [インストール先のフォルダ] 画面が表示されるのでインストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」 ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.4-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ
    図2.2.1.4-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.4-1
    アイコン 説明
    分散管理機能 ドメインの分散管理に必要な機能をインストールします。
    ※クラスタドメイン(*1)を作成する場合、選択します。
      分散管理サーバ 分散管理サーバは、分散配置されたサーバ上のドメイン群をグルーピングし、個々のドメインへのアプリケーション配備や設定作業を一元化する運用基盤を提供します。この機能をインストールする場合、「Working Domain Coordinator」もインストールされます。
    Working Domain Coordinator Working Domain Coordinatorは、負荷分散装置の利用を前提として構築された複数のサーバを効率よく 利用するために、業務アプリケーションの負荷に応じて、処理を行うサーバの数を調節する機能を提供します。
    拡張機能 オプションの拡張機能をインストールします。 既定値ではインストールされません。 次の選択アイコンからオプションの拡張機能を選択できます。
      Object Broker CNS Object Broker CNS(キャッシュ名前サーバ)は、複数の名前サーバのキャッシュを構築して信頼性の向上と負荷分散を行います。
    Object Broker Applet Proxy Object Broker Applet ProxyはJavaアプレットとWebサーバ以外で動作するCORBAサーバ間の通信機能を提供します。
    WatchServer WatchServerは、WebOTX ASをマルチサーバの負荷分散構成とした場合に、アプリケーションサーバの監視機能と障害発生時の縮退運転機能を提供します。
    *1
    Working Domain Coordinatorの機能により、業務アプリケーションの負荷に応じて、処理を行うサーバの数を調節することが可能です。(負荷分散装置の利用を前提としています)
  6. [カスタムセットアップ]画面で、「Working Domain Coordinator」を選択した場合は、[インストール済みの JDK] 画面が表示されますので、既にマシンにインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、複数の JDK がインストールされている場合、最後にインストールした JDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。
    ※Windows(x86)プラットフォームの場合は32bit版のJDK、Windows(x64)プラットフォームの場合は64bit版のJDKがインストールされているフォルダを指定してください。それ以外のフォルダが指定されている場合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。

    インストール済みの JDK
    図2.2.1.4-6

  7. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図2.2.1.4-7

  8. [WebOTX Application Server Enterprise をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中画面
    図2.2.1.4-8

  9. [カスタムセットアップ]画面で、「Working Domain Coordinator」を選択した場合は、ファイルのコピーが終わると、WebOTX の初期ドメイン環境(WebOTXAdmin、クラスタドメイン)を Apache Antコマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は${AS_INSTALL}\ant_setup.log で確認できます。

    ant_setup.bat実行画面
    図2.2.1.4-9

  10. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。 なお、CORBAアプリケーションをVisual Studio 2015でビルドし、WebOTXで実行するためには、Universal C Runtimeの更新プログラムを適用する必要がある旨のメッセージが出力されます。

    インストール完了画面
    図2.2.1.4-10

  11. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.5. WebOTX Administrator

  1. WebOTXメディアのDVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Administrator V9.4]を選び、「Install」ボタンを押してください。

    DVD 媒体 を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.5-1

  2. Windowsインストーラが起動し、「インストールの準備中」というメッセージが表示されたあと、 次の画面が表示されます。「次へ」ボタンを押してください。

    運用環境のインストーラ開始画面
    図2.2.1.5-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力します。
    [ライセンスキー] ボックスには、製品に添付されている 「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号を正しく入力します。
    入力した情報に間違いがなければ「次へ」ボタンを押してください。

    ユーザ名登録画面
    図2.2.1.5-3

  4. [インストール先のフォルダ] 画面が表示されますので、インストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.5-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ画面
    図2.2.1.5-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.5-1
    アイコン 説明
    統合運用管理ツール GUIベースの統合運用管理ツールをインストールします。
    ダウンローダ管理ツール ダウンローダ管理ツールをインストールします。


  6. [カスタムセットアップ]画面で、「統合運用管理ツール」を選択した場合、[インストール済みの JDK] 画面が表示されますので、既にインストールされている JDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。
    ※Windows(x86)プラットフォームの場合は32bit版のJDK、Windows(x64)プラットフォームの場合は64bit版のJDKがインストールされているフォルダを指定してください。それ以外のフォルダが指定されている場合は「次へ」ボタンが無効表示になりますので、正しく指定しなおしてください。

    インストール済みの JDK
    図2.2.1.5-6

  7. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図2.2.1.5-7

  8. [WebOTX Administrator をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中の画面
    図2.2.1.5-8

  9. [カスタムセットアップ]画面で、「統合運用管理ツール」を選択した場合、WebOTX の環境を Apache Antコマンドで設定するため、次の画面が表示されます。画面が終了するまでしばらくお待ちください。Apache Ant コマンドの実行結果は${AS_INSTALL}\ant_setup.log で確認できます。

    ant_setup.bat実行画面
    図2.2.1.5-9

  10. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。

    インストール終了画面
    図2.2.1.5-9

    Caution
    ダウンローダ管理ツールをインストール時、イベントログに SideBySide のエラーが記録されますが、ダウンローダ管理ツールの動作に影響はありません。

    詳細は[ 注意制限事項 > 1. インストール/アンインストール > 1.1. Windows版 > 1.1.1. 注意事項 > 1.1.1.3. ダウンローダ管理ツールインストール時のイベントログについて ]を確認してください。

  11. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.6. WebOTX マニュアル

Caution
マニュアルをインストールするには、ディスク容量として 約 500MB の空き容量が必要です。
  1. WebOTXメディアの DVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Manual V9.4 (1st)] を選び、「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記のいずれかを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.6-1

  2. Windowsインストーラが起動し、「WebOTX Manual」のインストールが始まります。
    画面の指示にしたがって、処理を続行してください。
     
  3. 「WebOTX Manual」のインストールが完了します。

以上でWebOTX マニュアルのインストールは完了です。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.7. WebOTX Client

  1. WebOTXメディアのDVD 媒体を DVD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Client V9.4]を選び、「Install」ボタンを押してください。

    DVD 媒体を挿入しても下の画面が自動的に表示されない場合は、 エクスプローラで下記ファイルを実行してください。 (下の画面は DVD 媒体を挿入した場合の画面です。)

    <ドライブ>:\wo_setup.exe
    <ドライブ>は、DVD-ROMドライブのドライブ文字です。

    WebOTX メディアの開始画面
    図2.2.1.7-1

  2. Windowsインストーラが起動し「インストールの準備中」というメッセージ が表示されたあとに次の画面が表示されます。 「次へ」ボタンを押してください。

    クライアントインストーラ開始画面
    図2.2.1.7-2

  3. [ユーザ情報] 画面が表示されますので、[ユーザ名] ボックスと[所属] ボックスに名前、所属を入力し「次へ」ボタンを押してください。

    ユーザ名登録画面
    図2.2.1.7-3

  4. [インストール先のフォルダ] 画面が表示されるのでインストール先フォルダを決定し「次へ」ボタンを押してください。
    インストール先フォルダを変更する場合には「変更」 ボタンを押してください。
    他のWebOTX 製品がすでにインストールされている場合、同じフォルダを指定してください。

    インストール先のフォルダ
    図2.2.1.7-4

  5. [カスタムセットアップ] 画面が表示されます。インストールする機能を選択し「次へ」ボタンを押してください。

    カスタムセットアップ画面
    図2.2.1.7-5

    リストの各アイコンを選択した時の動作は次のとおりです。

    表2.2.1.7-1
    アイコン 説明
    Javaクライアント実行環境 WebOTX Javaクライアント実行環境をインストールします。
    [Object Broker Javaクライアント実行環境]、[Javaベースライブラリ]、 [Transaction Service Javaクライアント実行環境]、[JDBCデータソース] および [JMS]を選択できます。
      Object Broker Javaクライアント実行環境 Object Broker Javaクライアント実行環境をインストールします。 他のクライアント製品の動作に必要なため、必ずインストールされます。
    Javaベースライブラリ Javaベースライブラリをインストールします。 他のクライアント製品の動作に必要なため、必ずインストールされます。
    WebOTX Javaクライアント実行環境 WebOTX Javaクライアント実行環境をインストールします。
    Transaction Service クライアント実行環境 / JDBCデータソース Transaction Service クライアント実行環境およびJDBCデータソースをインストールします。 クライアントでトランザクションを開始する場合に選択します。
      旧バージョン互換ライブラリ 旧バージョン(V6以前)のTransaction Serviceアプリケーションを動作させる場合に選択します。
    JMS JMS(クライアント)をインストールします。
    C++クライアント実行環境 WebOTX C++クライアント実行環境をインストールします。
    [Object Broker C++クライアント実行環境]、[WebOTX C++クライアント実行環境] および[Transaction Service クライアント実行環境]を選択できます。
      Object Broker C++クライアント実行環境 Object Broker C++クライアント実行環境をインストールします。
    他のクライアント製品の動作に必要なため、必ずインストールされます。
    WebOTX C++クライアント実行環境 WebOTX C++クライアント実行環境をインストールします。
    Transaction Service クライアント実行環境 Transaction Service クライアント実行環境をインストールします。 クライアントでトランザクションを開始する場合に選択します。
      旧バージョン互換ライブラリ 旧バージョン(V6以前)のTransaction Serviceアプリケーションを動作させる場合に選択します。

    Visual Basicクライアント実行環境 (*1)

    WebOTX Visual Basicクライアント実行環境をインストールします。
    [Object Broker C++クライアント実行環境]、[WebOTX C++クライアント実行環境]、 [COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ)]、[Transaction Service クライアント実行環境] および、[Visual Basic 6.0クライアント実行環境]を選択できます。
      Object Broker C++クライアント実行環境 Object Broker C++クライアント実行環境をインストールします。
    他のクライアント製品の動作に必要なため、必ずインストールされます。
    WebOTX C++クライアント実行環境 WebOTX C++クライアント実行環境をインストールします。
    COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ) COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ)をインストールします。
    必ずインストールされます。
    Transaction Service クライアント実行環境 (*2) Transaction Service クライアント実行環境をインストールします。 クライアントでトランザクションを開始する場合に選択します。
      旧バージョン互換ライブラリ 旧バージョン(V6以前)のTransaction Serviceアプリケーションを動作させる場合に選択します。
    Visual Basic 6.0クライアント実行環境 Visual Basic 6.0 用クライアント実行環境をインストールします。
    ASP実行環境 (*1) ASP(Active Server Pages)用の実行環境をインストールします。
    [Object Broker C++クライアント実行環境]、[WebOTX C++クライアント実行環境]、 [COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ)]、[Transaction Service クライアント実行環境] および、[ASP配備サービス]を選択できます。
      Object Broker C++クライアント実行環境 Object Broker C++クライアント実行環境をインストールします。
    他のクライアント製品の動作に必要なため、必ずインストールされます。
    WebOTX C++クライアント実行環境 WebOTX C++クライアント実行環境をインストールします。
    必ずインストールされます。
    COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ) COM/Bridge機能 (CORBAゲートウェイ, EJBゲートウェイ)をインストールします。
    必ずインストールされます。
    Transaction Service クライアント実行環境 (*2) Transaction Service クライアント実行環境をインストールします。 クライアントでトランザクションを開始する場合に選択します。
      旧バージョン互換ライブラリ 旧バージョン(V6以前)のTransaction Serviceアプリケーションを動作させる場合に選択します。
    ASP配備サービス ASP配備サービスをインストールします。
    必ずインストールされます。
    ダウンローダ ダウンローダをインストールします。
    *1
    64bit OSの場合、WOW64(32bit版)対応版を提供します。
    *2
    64bit OS上でWOW64(32bit版)のTransaction Service クライアント実行環境は提供されません。


  6. [プログラムをインストールする準備ができました] 画面が表示されます。「インストール」ボタンを押してください。

    インストール開始画面
    図2.2.1.7-6

  7. [WebOTX Client をインストールしています] 画面が表示され、ファイルのコピーが始まります。選択された機能により、セットアップに 必要な時間は異なります。ファイルのコピーが終了するまでお待ちください。

    インストール中の画面
    図2.2.1.7-7

  8. [カスタムセットアップ] 画面で「ダウンローダ」を選択していた場合、以下の画面が表示されますのでダウンローダの設定を入力し「OK」ボタンを押してください。

    インストール終了画面
    図2.2.1.7-8

  9. [カスタムセットアップ] 画面で「Java クライアント実行環境」を選択していた場合、ファイルのコピーが終わると次の画面が表示されます。画面が終了するまでしばらくお待ちください。

    ant_setup.bat実行画面
    図2.2.1.7-9

  10. 次の画面が表示されたら、セットアップは完了です。「完了」ボタンを押してください。 なお、C++クライアント実行環境を選択した場合、CORBAアプリケーションをVisual Studio 2015でビルドし、WebOTXで実行するためには、Universal C Runtimeの更新プログラムを適用する必要がある旨のメッセージが出力されます。 Windows(x64)プラットフォームの場合は、[注意制限事項 > 13. TPモニタ > 13.2. 制限事項 > 13.2.6. Microsoft Visual Studio 2015 のランタイムライブラリについて ]もご確認ください。


    インストール終了画面
    図2.2.1.7-10

  11. コンピュータを再起動してください。コンピュータを再起動しないとWebOTXは正常に動作しません。

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.1.8. EnterpriseDirectoryServer

WebOTX DVD 媒体内に格納されるEnterpriseDirectoryServerの位置を確認してください。 セットアップ方法は、DVD 媒体に格納される EnterpriseDirectoryServer付属のセットアップカードを参照しながら行ってください。

セットアップカードは以下の場所にあります。

<ドライブ>:\EDS\SetupCard\EDS_SetupCard.pdf
<ドライブ>は、DVD-ROMドライブのドライブ文字です。

2.2.2. HP-UX、Linux

WebOTX AS Express/Standard/Enterprise/Developer/Administratorのインストール方法について説明します。

インストールスクリプト(WOINST.SH)で登録可能なライセンスは一つです。そのため、ライセンスの追加登録はライセンス登録コマンドにより行います。 また、インストール後にCPU割当追加などシステム環境を変更する場合、ライセンスの追加登録が必要となるケースがあります。 ライセンス登録コマンドの使用方法については、[ 2.4. 製品ライセンスの追加登録 > 2.4.3. HP-UX、Linux ]を参照してください。

Caution
WebOTX AS Express/Standard/Enterprise V9.4から登録されているライセンス数が不足している場合、ドメイン起動時に以下のようなWARNINGメッセージが${INSTANCE_ROOT}/logs/webotx_agent.logに出力されます。
WARNINGメッセージが出力される場合、[ 2.4. 製品ライセンスの追加登録 > 2.4.3. HP-UX、Linux ]を参照してライセンスの追加登録を行ってください。
OTX01130084: The number of registered licenses is * fewer than it is required. The system has * processors, but * license(s) is/are registered. Product Name: WebOTX Application Server Express/Standard/Enterprise V*.*

OTX01130084: ライセンス登録数が * 不足しています。CPUコア数 * に対して登録数が * です。製品名: WebOTX Application Server Express/Standard/Enterprise V*.*
"*"には環境に応じた数字、もしくは製品のバージョンが出力されます。

WebOTXの製品のインストールはインストールスクリプトを使用して行ないます。 ただし、一部の機能においてはインストールコマンドを使用して個別インストールする必要があります。 こちらは、プラットフォームごとに手順が異なります。 個別インストールは、[ 2.2.2.8. コマンドによる追加インストール ]を参照してください。

インストールスクリプトによる製品インストール時は、次の点に留意してください。

2.2.2.1. WebOTX Application Server Express

2.2.2.2. WebOTX Application Server Standard

2.2.2.3. WebOTX Application Server Enterprise

V8でクラスタ機能を提供していたWebOTX Clusterは、V9からWebOTX Application Server Enterpriseに統合されました。
WebOTX Application Server Enterprise の全機能(クラスタ機能も含みます)をインストールする場合、インストールスクリプトのインストールパターン選択画面にて「1. Install WebOTX Application Server Enterprise」 を選択します。
V8までのWebOTX Clusterと同様にクラスタ機能のみをインストールする場合は、インストールスクリプトのインストールパターン選択画面にて「2. Install only cluster function」を選択します。

Caution
WebOTX AS Enterpriseのインストール完了後にインストールパターン(WebOTX AS Enterpirse全機能インストール/クラスタ機能のみインストール)を変更することはできません。インストールパターンを変更する場合は、再インストールが必要となります。

2.2.2.4. WebOTX Administrator

2.2.2.5. WebOTX Client

2.2.2.6. マニュアル

2.2.2.7. 複数バージョンインストールについて

本バージョンと他のバージョンを同一マシンにインストールする場合、下記のパターンによりインストール時の選択内容とインストール後の設定作業が異なります。

(1) 両方のバージョンのドメインを同時起動しない場合(片方のバージョンのドメインのみ起動)
(2) 両方のバージョンのドメインを同時起動する場合

設定方法は下記の通りです。

Caution
インストール・ベースディレクトリを/optから変更している場合、各マニュアルのコマンド実行/ファイルパス名/ディレクトリ変更等に記載されている/optをインストール時に指定したインストール・ベースディレクトリに読み替えてください。

(例) インストール・ベースディレクトリとして/opt/WebOTX94を指定した場合

また、各マニュアルでWebOTX Utility (OTX94UTIL)及びアンインストールスクリプト(wouninst.sh)のコマンド実行/ファイルパス名/ディレクトリ変更等に記載されている/opt/share.necを/opt/share.nec/v94に読み替えてください。


Caution
V9.2以前のバージョンのWebOTX Utility(OTXUTIL)やWebOTX製品を追加でインストールする場合、インストール済の本バージョンのWebOTX製品のインストール・ベースディレクトリが/opt以外となっていることを確認してください。
本バージョンのWebOTX製品のインストール・ベースディレクトリが/optである場合、V9.2以前のバージョンのWebOTX Utility(OTXUTIL)やWebOTX製品を追加でインストールを行わないでください。
HP-UX(IPF)版ではV9.2以前のバージョンのWebOTX Utility(OTXUTIL)やWebOTX製品をインストールした場合、本バージョンのWebOTX製品のファイルが上書きされます。
※Linux(x64)版はエラーとなります

2.2.2.8. コマンドによる追加インストール

インストールコマンドによるインストール方法はプラットフォームにより異なります。 通常はインストールスクリプトを利用したインストールだけで完了しますが、一部の機能を追加で利用する場合にはこの作業が必要となります。

2.2.2.9. HP-UX

swinstall コマンドを使用してインストールします。 手順は次のとおりです。

  1. ログイン名 root でログインします。
    login: root
  2. マシンのDVD-ROMドライブに、WebOTXメディアのDVD媒体を挿入してください。 DVD-ROMドライブをマウントします。
    root> cd /
    root> mount -F cdfs -r /dev/dsk/c1t2d0 /SD_CDROM

    上記の mount コマンドで指定したスペシャルファイル名はDVD-ROMドライブの SCSI IDによって異なります。マシンの設定にあわせて指定してください。

  3. rpm -i コマンドでインストールを行います。
    手動インストールが必要なのは以下の製品です。必要に応じてインストールしてください。

    HP-UX(IPF)の場合

  4. DVD-ROMをアンマウントします。
    root> cd /
    root> umount /SD_CDROM

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.2.10. Linux

以下の説明では、RHEL での標準マウントポイント「/media/cdrom」に、WebOTXメディアのDVD媒体をマウントしたものとして説明しています。
rpm コマンドを使用してインストールします。 手順は次のとおりです。

  1. ログイン名 root でログインします。
    login: root
  2. マシンのDVD-ROMドライブに、WebOTXメディアのDVD媒体を挿入してください。 DVD-ROMドライブをマウントします。
    root> cd /
    root> mount -t iso9660 /dev/cdrom /media/cdrom
  3. rpm -i コマンドでインストールを行います。
    手動インストールが必要なのは以下の製品です。必要に応じてインストールしてください。

    Linux(x64)の場合

    ※ xはRPMファイルのリビジョン番号です。インストールに使用するWebOTX Mediaのリリースメモ、もしくはWebOTX Mediaの上記ディレクトリを参照し、RPMファイル名を確認してください。

  4. DVD-ROMをアンマウントします。
    root> cd /
    root> umount /media/cdrom

次は、[ 2.3. インストール後の作業 ]を行います。

2.2.2.11. インストーラ圧縮ファイル

リモートでの作業などDVD媒体を使用できない場合、V9からはインストーラ圧縮ファイル(tar.gz形式)を利用してインストールすることが可能になりました。
インストーラ圧縮ファイルの作成は、インストーラ圧縮ファイル作成スクリプト(WOMKTGZ.SH)を使用して行います。

インストーラ圧縮ファイルの作成手順は次のとおりです。

  1. ログイン名 root でログインします。
    login: root
  2. マシンのDVD-ROMドライブに「WebOTX Media (DVD) #1」を挿入してマウントします。
     
    HP-UXの場合、下記のmountコマンドで指定するスペシャルファイル名がDVD-ROMドライブの SCSI IDによって異なる場合があります。 マシンの設定にあわせて指定してください。

  3. DVD-ROMのマウント・ポイント・ディレクトリへ移動してください。
  4. インストーラ圧縮ファイル作成スクリプトを起動してください。
    root> ./WOMKTGZ.SH
  5. スクリプトの指示にしたがって、インストールする製品を選択してください。
    Please select one of the following products:
    
       1. WebOTX Application Server Express
       2. WebOTX Application Server Standard
       3. WebOTX Application Server Enterprise
       4. WebOTX Developer
       5. WebOTX Administrator
       6. WebOTX Client (for Linux(x64))
       7. WebOTX Client (for HP-UX(IPF))
       8. WebOTX Application Server Express (for Ubuntu)
      99. Cancel
    

    Express の場合は「1」を、Standard の場合は「2」を、Enterprise の場合は「3」を入力します。

    その他、Developer (旧名称: 開発環境)の場合は「4」を、Administrator (旧名称: 運用環境)の場合は「5」を入力します。
    Clientの場合は、利用するプラットフォームに応じて「6」か「7」を入力します。

    Ubuntu用のExpressの場合は「8」を入力します。

    Caution
    「8. WebOTX Application Server Express (for Ubuntu)」と以下のメッセージはLinux(x64)のみ表示されます。HP-UX(IPF)の場合は表示されません。
    When selecting from "1" to "6" on the menu, a compressed file of RPM will be made.
       Please select "8" for installation of WebOTX product in Ubuntu machine.

  6. インストーラ圧縮ファイルの出力先ディレクトリを絶対パスで入力します。
    Please enter the directory name with an absolute path. (Default: /tmp)

    ディレクトリが存在しない場合、ディレクトリ作成確認の画面が表示されます。
    作成する場合は「y」を、作成しない場合は「n」を入力してください。
    作成しない場合、インストーラ圧縮ファイルの出力先ディレクトリの確認画面が再度表示されます。

    Would you like to make the directory?  [y,n] (Default: y)
  7. インストーラ圧縮ファイルの作成開始確認画面が表示されます。
    ***********************************************************************
    * Making a compressed file for installation of WebOTX V9.4 product.   *
    * To continue, enter y. Enter q to exit. [y, q] (Default: y)          *
    ***********************************************************************
    

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

    キャンセルした場合はインストールスクリプトが終了します。 再実行する場合は、「4.」のインストーラ圧縮ファイル作成スクリプトの実行からやり直してください。

  8. 選択した製品のインストーラ圧縮ファイルが以下のファイル名で指定ディレクトリに作成されます。
    表2.2.2.11-1
    製品名 ファイル名
    WebOTX Application Server Express webotx_as_exp_(PF名)_(バージョン番号).tar.gz
    WebOTX Application Server Standard webotx_as_std_(PF名)_(バージョン番号).tar.gz
    WebOTX Application Server Enterprise webotx_as_ent_(PF名)_(バージョン番号).tar.gz
    WebOTX Developer webotx_dev_(PF名)_ (バージョン番号).tar.gz
    WebOTX Administrator webotx_adm_(PF名)_ (バージョン番号).tar.gz
    WebOTX Client webotx_cli_(PF名)_(バージョン番号).tar.gz
    WebOTX Application Server Express (for Ubuntu) webotx_as_exp_linux_x64_Ubuntu_(バージョン番号).tar.gz

    *1 (PF名)にはLinux(x64)は"linux_x64"、HP-UX(IPF)は"hpux_ipf"が入ります。
    *2 (バージョン番号)にはV9.4の場合は"0940"、V9.41の場合は"0941"のように入ります。

  9. DVD-ROMをアンマウントします。

インストーラ圧縮ファイルを利用するインストール手順は次のとおりです。
※インストーラ圧縮ファイルは対象マシンに転送済であることを前提とします。

  1. ログイン名 root でログインします。
    login: root
  2. インストーラ圧縮ファイルを転送したディレクトリに移動して、以下のコマンドで展開してください。
    ※移動先ディレクトリにて別のインストーラ圧縮ファイルを展開済の場合、他のディレクトリで展開してください。
    root> gzip -dc (インストーラ圧縮ファイル) | tar xf -
  3. 展開されたインストールスクリプトを起動すると、インストール可能な製品が表示されます。
    インストールする場合は「y」を入力してください。セットアップが始まります。
    中止する場合は「n」を入力してください。
    root> ./WOINST.SH
    
    You can install the following product from the result of the expansion of the compressed file.
     (インストール可能な製品名)
    
    Would you like to continue?  [y,n] (Default: y)
  4. 以降はDVD媒体からのインストールと同じ手順でインストールを行います。
    各製品のインストール手順を参照してください。
Caution
インストーラ圧縮ファイルの留意点に関しては [製品構成と提供機能 > 3. 提供機能 > 3.11. インストール/アンインストール > 3.11.2. UNIX版 > 3.11.2.3. インストーラ圧縮ファイル ]を参照してください。

2.2.2.12. Enterprise Directory Server

Enterprise Directory Serverのインストールは「WebOTX Media DVD-ROM #1」から行います。 Enterprise Directory Server付属のセットアップカードを参照してインストールを行ってください。

セットアップカードは以下の場所にあります。

2.2.3. サイレントインストール

WebOTX AS Express/Standard/Enterprise/Administrator/Client のサイレントインストール方法について説明します。

2.2.3.1. Windows

コマンドプロンプトによるサイレントインストール

Windows版のサイレントインストールは、次のコマンド引数を設定して各インストーラ(setup.exe)を実行します。各インストーラをデフォルト値でインストールする場合に設定するコマンド引数は次の通りです。

表2.2.3.1-1
製品名 説明
WebOTX AS Express <DVDドライブ>:\EXP\setup.exe /v"LIC_KEY=\"Expressのライセンスキー\" /qr"
WebOTX AS Standard <DVDドライブ>:\STD\setup.exe /v"LIC_KEY=\"Standardのライセンスキー\" /qr"
WebOTX AS Enterprise <DVDドライブ>:\ENT\setup.exe /v"LIC_KEY=\"Enterpriseのライセンスキー\" /qr"
WebOTX Administrator <DVDドライブ>:\ADM\setup.exe /v"LIC_KEY=\"Administratorのライセンスキー\" /qr"
WebOTX Client <DVDドライブ>:\CLI\setup.exe /v"/qr"

デフォルト値以外の値を設定する場合は、次のプロパティ情報を /qr の前に追加してください。

Explorerによるワンタッチインストール

以下の製品は、インストーラを直接起動することにより、ライセンスキーのみの入力でインストールの実行が可能です。
この場合、インストール時に利用されるパラメータは既定値となります。

製品名 実行ファイル名
WebOTX Application Server Express <ドライブ>:\EXP\setup.exe
WebOTX Application Server Standard <ドライブ>:\STD\setup.exe
WebOTX Application Server Enterprise <ドライブ>:\ENT\setup.exe
WebOTX Administrator <ドライブ>:\ADM\setup.exe
WebOTX Developer <ドライブ>:\DEV\setup.exe
<ドライブ>は、DVD-ROMドライブのドライブ文字です。

2.2.3.2. HP-UX、Linux

UNIX版のサイレントインストールでは、サイレントインストール用の設定ファイルをインストーラ(WOINST.SH)に読み込ませて実行します。設定ファイルを作成/確認する機能及び設定ファイルの内容に従いインストールを実行する機能を提供します。 サイレントインストールの対象となる製品は以下の通りです。

・サイレントインストール用の設定ファイルの作成

以下の手順でサイレントインストール用の設定ファイルを作成します。

root> ./WOINST.SH --make-silent-file=filename
root> ./WOINST.SH -m filename

上記コマンド実行後は、通常のインストーラ実行時と同じ選択肢に加えてJAVA_HOMEの入力が表示されます。各選択肢及びJAVA_HOMEに対して入力を行うと、入力した値が指定した設定ファイルに保存されます。

・サイレントインストール用の設定ファイルの確認

インストール対象マシンにおいてサイレントインストール用の設定ファイルがインストールに利用可能か、以下の手順で確認します。

root> ./WOINST.SH --check-silent-file=filename
root> ./WOINST.SH -c filename

上記コマンド実行後は、サイレントインストール実行時と同じように、インストーラの各選択肢に対して設定ファイルから読み込んだプロパティの値が反映されて表示されます。インストーラの選択に対して設定ファイルの内容が全て入力されると、チェックが正常終了したことを表示してインストールスクリプトは終了します。

・サイレントインストールの実行

以下の手順でサイレントインストール用の設定ファイルをインストーラに読み込ませてインストールを実行します。

root> ./WOINST.SH --silent-file=filename --license=license key
root> ./WOINST.SH -s filename -l license key

上記コマンド実行後は、インストーラの各選択肢に対して設定ファイルから読み込んだプロパティの値が反映されてインストールが実行されます。また、オプションで指定されたライセンスキーを使用して、製品のライセンスを登録します。

実施例

インストーラを利用してサイレントインストール用の設定ファイルを作成します。
root> ./WOINST.SH -m /test/install_exp.txt
以下の構成でインストールする場合、インストーラの各選択肢に対して[入力値]に従って入力します。
表2.2.3.2-1
選択肢 選択値 入力値
製品の選択 WebOTX AS Expressを選択する 1を入力
インストール・ベースディレクトリの入力 インストール・ベースディレクトリを入力する /opt/WebOTX94を入力
利用するJDKの入力 JDKへの絶対パスを入力する /usr/java/jdk1.7.0_xxを入力
インストールタイプの入力 カスタムを選択する nを入力
運用管理ユーザの指定 指定しない(root) nを入力
ユーザドメインの作成 デフォルトにする(作成する) 何も入力せずにエンターキーを押す
Webサーバの選択 WebOTX Webサーバ2.2を選択する 1を入力
SSL module(mod_ssl) for Web Server 2.2のインストール インストールする yを入力
ユーザドメイン名の指定 デフォルトにする(domain1) 何も入力せずにエンターキーを押す
管理ドメインの運用制御用のポート番号の指定 デフォルトのポート番号(6202)にする 8080を入力する
HTTPポート番号の指定 8080を指定する 8080を入力する
HTTPSポート番号の指定 8443を指定する 8443を入力する

上記の手順で作成した設定ファイルの内容は以下となります。
※コメントアウトされているプロパティはサイレントインストール時にデフォルト値を使用、もしくはインストール対象製品で未使用のプロパティです。

OTX_FORMAT_VERSION=940
OTX_INST_BASE=/opt/WebOTX94
JAVA_HOME=/usr/java/jdk1.7.0_xx
OTX_PRODUCT=exp
OTX_INST_TYPE=custom
#OTX_INST_PATERN=
#OTX_ADM_USER=
#OTX_ADM_GROUP=
#OTX_WEBCONT_MODE=
#OTX_LISTENER_PROTOCOL=
OTX_WEBSV_TYPE=websv22
#OTX_USER_DOMAIN=
#OTX_DOMAIN_NAME=
#OTX_CLUST_DOMAIN=
#OTX_ADMDOMAIN_PORT=
OTX_HTTP_PORT=8080
OTX_HTTPS_PORT=8443
#OTX_PRG_LANG=
OTX_OPT_MODSSL=y
#OTX_OPT_OTXDL=
#OTX_OPT_OTXSSL=
#OTX_OPT_OSPIPRX=
#OTX_OPT_OSPICNS=
#OTX_OPT_OTXWS=
#OTX_OPT_OTXDMSV=
#OTX_OPT_OTXWDC=
#OTX_OPT_IRSJDBC=
#OTX_OPT_OTXEJMSD=
#OTX_OPT_OLFTPDEV=
#OTX_OPT_OTXTSCL=
#OTX_OPT_OTXEJMSC=
#OTX_OPT_OTXJCL=
#OTX_OPT_OTXCCL=
#OTX_OPT_OTXTSCCMPT=
以下のコマンドを実行すると、上記の設定ファイルの内容に従いサイレントインストールを行います。
root> ./WOINST.SH -s /test/install_exp.txt -l license key
サイレントインストールの設定ファイルのプロパティは次の通りです。
表2.2.3.2-2
プロパティ名 プロパティ値の設定内容 区分 オプションの
対象製品
備考
OTX_FORMAT_VESRION 940 (*1) 必須 サイレントインストール設定ファイルのフォーマットバージョン(固定値)
OTX_INST_BASE インストール・ベースディレクトリ オプション 全製品 絶対パスで指定。省略時はマシン環境に従ってデフォルトのインストール・ベースディレクトリ("/opt" or "/opt/WebOTX94")を使用。※追加製品インストール時は未使用。Ubuntuの場合、常に未使用で/opt固定インストール
JAVA_HOME JDKへのインストールパス オプション 全製品 絶対パスで指定。設定時は環境変数の値より優先して使用。省略時は環境変数の値を使用。環境変数の値が未設定の場合は必須。※追加製品インストール時は未使用
OTX_PRODUCT exp (WebOTX AS Express)
std (WebOTX AS Standard)
ent (WebOTX AS Enterprise)
dev (WebOTX Developer)
adm (WebOTX Administrator)
cli (WebOTX Client)
必須
OTX_INST_TYPE default (デフォルト)
custom (カスタム)
必須 default (デフォルト)の場合、JAVA_HOME以外のオプションのプロパティは全て未使用
OTX_INST_PATERN ent(WebOT AS Enterprise全機能)
clust (クラスタ機能のみ)(*)
オプション WebOTX AS Enterprise デフォルト値はent
* V8までのWebOTX Cluster相当
OTX_ADM_USER WebOTX運用管理ユーザ オプション 全製品 省略時はWebOTX運用管理ユーザの設定を行わない(ファイルオーナーはroot)
OTX_ADM_GROUP WebOTX運用管理ユーザのグループ オプション 全製品 OTX_ADM_USER定義されている場合は必須
OTX_WEBCONT_MODE adv (アドバンスドモード)
std (スタンダードモード)
オプション WebOTX AS Standard/Enterprise デフォルト値はadv(アドバンスドモード)
OTX_LISTENER_PROTOCOL ajp (AJPリスナ)
iiop (IIOPリスナ)
オプション WebOTX AS Standard/Enterprise デフォルト値はajp (AJPリスナ)。OTX_WEBCONT_MODEがadvの時のみ使用。
OTX_WEBSV_TYPE websv22 (WebOTX Webサーバ2.2)
websv24 (WebOTX Webサーバ2.4)
intwebsv (内蔵Webサーバ)
noinstall(WebOTX Webサーバインストール無) (*)
オプション WebOTX AS expのデフォルト値はintwebsv(内蔵Webサーバ)
std/entのデフォルト値はアドバンスドモード:websv24 (WebOTX Webサーバ2.4)、スタンダードモード:intwebsv(内蔵Webサーバ)
* noinstallはアドバンスドモードかつAJPリスナで別マシンのWebサーバと連携する場合に選択。別マシンのプラットフォームがWindowsの場合、Microsoft Internet Information Services (IIS)も利用可能
OTX_USER_DOMAIN y (ユーザドメイン作成)
n (ユーザドメイン作成しない)
オプション WebOTX AS デフォルト値はy (ユーザドメイン作成)
OTX_DOMAIN_NAME ユーザドメイン名 オプション WebOTX AS デフォルト値はdomain1 (*2)
OTX_CLUST_DOMAIN y (クラスタドメイン作成)
n (クラスタドメイン作成しない)
オプション WebOTX AS Enterprise デフォルト値はn (クラスタドメイン作成しない)
OTX_ADMDOMAIN_PORT 管理ドメインの運用制御用ポート番号 オプション WebOTX AS デフォルト値は6202
OTX_HTTP_PORT HTTPポート番号 オプション WebOTX AS デフォルト値はOTX_ADM_USERが未定義の場合は80、定義している場合は8080(*3)
OTX_HTTPS_PORT HTTPSポート番号 オプション WebOTX AS デフォルト値はOTX_ADM_USERが未定義の場合は443、定義している場合は8443。(*3)
WebOTX Webサーバ2.2/2.4選択かつOTX_OPT_MODSSL未定義時は本プロパティは未使用
OTX_PRG_LANG both (C++/Java Client)
cplus (C++ Client)
java (Java Client)
オプション WebOTX Client デフォルト値はboth (C++/Java Client)
OTX_OPT_MODSSL [Webサーバ用SSL通信モジュール]
y (インストールする)
n (インストールしない)
オプション WebOTX AS WebOTX Webサーバ2.2/2.4を選択かつ、WebOTX Webサーバ2.2/2.4でSSL通信を行う場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OTXDL [Download Contetns]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise Download Contetnsを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXSSL [Library for IIOP over SSL]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Standard/Enterprise TPモニタ上で動作するIIOPリスナの通信をSSLで暗号化を行う場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OSPIPRX [Object Broker Applet Proxy]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise Object Broker Applet Proxyを使用する場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OSPICNS [Object Broker CNS]]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise Object Broker CNS(キャッシュ名前サーバ)を使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXWS [Watch Server]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise Watch Serverを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXDMSV [分散管理サーバ]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise 分散管理サーバを使用する場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OTXWDC [Working Domain Coordinator]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise Working Domain Coordinatorを使用する場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OTXDMSVの値がyの場合、本プロパティの値に関係なくインストールされる
OTX_OPT_IRSJDBC [IRS用JDBCドライバ]
y (インストールする)
n (インストールしない)
オプション WebOTX AS Enterprise InfoFrame Relational Store(IRS)用JDBCドライバを使用する場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OTXEJMSD [JMS開発環境]
y (インストールする)
n (インストールしない)
オプション WebOTX Developer JMS開発環境を使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OLFTPDEV [OLF/TP Adapter開発環境]
y (インストールする)
n (インストールしない)
オプション WebOTX Developer OLF/TP Adapter開発環境を使用する場合に選択
デフォルト値はn (インストールしない)
OTX_OPT_OTXTSCL [Transaction Service クライアント]
y (インストールする)
n (インストールしない)
オプション WebOTX Client Transaction Service クライアントを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXEJMSC [JMSクライアント]
y (インストールする)
n (インストールしない)
オプション WebOTX Client JMSクライアントを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXJCL [WebOTX Javaクライアント]
y (インストールする)
n (インストールしない)
オプション WebOTX Client WebOTX Javaクライアントを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXCCL [WebOTX C++クライアント]
y (インストールする)
n (インストールしない)
オプション WebOTX Client WebOTX C++クライアントを使用する場合に選択
デフォルト値はy (インストールする)
OTX_OPT_OTXTSCCMPT [Transaction Service クライアント互換ライブラリ]
y (インストールする)
n (インストールしない)
オプション WebOTX Client Transaction Service クライアントの旧バージョン互換ライブラリを使用する場合に選択
デフォルト値はn (インストールしない)
HP-UX(IPF)のみ有効なプロパティです。

*1 インストール対象製品追加やプロパティに関する変更等のサイレントインストール設定ファイルのフォーマット変更時に、フォーマットバージョンの値は更新されます。

*2 ドメイン名の命名規則は以下の通り。

*3 運用管理ユーザを利用する場合、OSの制約上、ポート番号として1024番以下の番号を利用することができません。

2.2.4. Docker用のコンテナイメージの作成

2.2.5. インストール時のエラーについて

インストール時にドメインの作成に失敗した場合、 [トラブルシューティングガイド > 2.5.6. JMX > 初期ドメインの生成失敗について] を参照して、確認を行ってください。

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

WebOTXをインストールした後に行う必要のある作業について、OS・WebOTX製品ごとに説明します。

さらにデータベースを使用する場合に行う作業についてアプリケーションの言語毎に説明します。

2.3.1. Windows (WebOTX AS) 共通設定

Windows版でWebOTX Application Serverをインストール後に行う必要のある作業について説明します。

WebOTX ASのインストーラは、セットアップ中にいくつかのWebOTXサービスをOSに登録します。 それらは、OS起動と共に開始するように設定されます。 そのため、インストール・セットアップを終えた後にマシンを再起動すると、WebOTXのサービスが起動している状態になります。

2.3.1.1. ドメインが正常に作成されているか確認

[ 4. 動作確認 > 4.1. Windows ] で説明される方法にしたがって、セットアップ中に作成された 2つのドメイン「WebOTXAdmin」と「ユーザドメイン」の動作状態を確認することによって、ドメインが正しく作成されていることを確認します。

WebOTXで利用するポート番号が起動済みの他のプログラムで利用しているポート番号と重複している場合、ドメインの生成に失敗する場合があります。
ドメインの生成に失敗した場合には、起動済みのプログラムの停止や、netstatコマンドなどを参照してポート番号の重複を解消してから、次のコマンドを起動しドメインを再生成してださい。

> ${AS_INSTALL}\ant_setup.bat

2.3.1.2. WebOTX 使用ポート番号を一時ポート対象範囲から除外

WebOTX ASが使用するポート番号が OSの一時ポートの割り当て範囲と重複していた場合、 WebOTX ASのサービスに定義されているポートが別のアプリケーションによって先に使用されることが原因で WebOTXの起動に失敗するなどの問題を引き起こすことがあります。

Windows Server 2008、Windows Server 2008 R2、Windows Server 2012、Windows Server 2012 R2 をご利用の場合、ポート番号「49152〜65535」が一時ポート範囲となります。

なお、OSの一時ポートの範囲が既定値のままであり、ドメインも既定値で作成している場合、ポート番号は重複しません。
このため、以下の手順を実施して頂く必要はございません。
ドメインの利用するポート番号をOS既定の一時ポート対象範囲内に設定した場合など、一時ポート対象範囲を変更する際は、以下の手順を実施してください。

  1. [スタート]-[プログラム]-[アクセサリ]-[コマンドプロンプト]を起動し、次のコマンドを入力してください。
    > netsh int ipv4 show dynamicport tcp
    > netsh int ipv4 show dynamicport udp
  2. 実行結果から、設定されている一時ポートの範囲を確認し、ドメインで利用するポートが範囲内に入っていないかを確認してください。

    実行結果例)
    =======================================
    プロトコル tcp の動的ポートの範囲
    ---------------------------------
    開始ポート      : 49152
    ポート数        : 16384
    =======================================
    

    上記の場合、一時ポートの範囲は、49152〜65536となります。この範囲のポートをドメインが使用していないかを、確認してください。

  3. 手順1で、ドメインで使用するポートが、一時ポートの範囲内だった場合、一時ポートの範囲を変更します。 以下のコマンドを実行し、ドメインで使用するポートが含まれないよう調整してください。
    > netsh int ipv4 set dynamicport tcp start=XXXXX num=YYYYY
    > netsh int ipv4 set dynamicport udp start=XXXXX num=YYYYY

    XXXXXには一時ポートの開始ポート、YYYYYには一時ポートとして使用するポート数を設定してください。

2.3.1.3. シャットダウンスクリプトの登録

WebOTX ASを起動した状態でOSのシャットダウンを行うと、OSによりWebOTX ASのプロセスが強制終了し、イベントログに以下の警告ログが出力されます。
(※)どちらかのみ出力される場合もあります。

OTX01205161: 予期せぬイベントにより、システム内部からアプリケーションサーバのシャットダウン要求が行われました。 (com.nec.webotx.enterprise.system.core)

Handle the signal : SIGTERM(15) [<ドメイン名>]

この問題を回避するためにWindows標準のシャットダウンスクリプトの登録を行ってください。以下に手順を示します。

  1. スクリプトの作成

    以下の一行を内容として含むスクリプトwoShutdown.batを作成し、C:\WINDOWS\system32\GroupPolicy\Machine\Scripts\Shutdownまたは環境に合わせた誤って削除されることのない場所に保存します。

    net stop WebOTXAgentService
    Caution
    C:\WINDOWS\system32\GroupPolicy\Machine\Scripts\Shutdown は Windows Server 2008 R2 以降では隠しフォルダになっております。
  2. [ファイル名を指定して実行]から「gpedit.msc」を起動します。
  3. 「グループポリシーエディター」の左ツリーの[ローカルコンピュータポリシー]-[コンピュータの構成]-[Windowsの設定]-[スクリプト]を辿り、右画面に表示される「シャットダウン」右クリックメニューよりプロパティを選択します。


    図2.3.1.3-1

  4. 「シャットダウンのプロパティ」の追加より先ほど作成したシャットダウンスクリプトを登録します。


    図2.3.1.3-2

  5. 「OK」ボタンを押し、ウィンドウを閉じてください。

2.3.1.4. Webサーバの動作設定(対象: Webサーバを利用する場合)

Webコンテナ内蔵型のWebサーバを利用する場合

WebOTX ASでは、HTTP/HTTPS サービスを、サーブレットやJSPが動作する機能層のWebコンテナ内部で動作させることができます。
それ以外のWebコンテナ外部のWebサーバを利用する場合は[Webコンテナ外部のWebサーバを利用する場合]に進んでください。

a. WebOTXドメインへの内部Webサーバ利用の設定

インストール時に、WebOTX Webサーバをインストールした場合、 デフォルトでWebOTX Webサーバが使用される設定がされています。
ここでは、WebOTX Webサーバを使用する設定から、内部Webサーバを使用する設定に変更する手順について説明しています。

  1. 運用管理コマンドを起動します。

    最初に、[スタート]-[プログラム]-[WebOTX]-[運用管理コマンド]から運用管理コマンドを起動してください。

  2. ドメインが起動していることを確認します。
    以下のコマンドを実行してください。
    otxadmin> list-domains
    停止状態の場合、以下のコマンドで起動してください。
    otxadmin> start-domain <ドメイン名>
  3. ドメインにログインします。
    以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    
  4. 外部Webサーバを使用する設定になっているか、WebOTX内蔵Webサーバを使用する設定になっているかを確認します。
    以下のコマンドを実行してください。
    otxadmin> get server.http-service.virtual-server.server.network-listeners
    上記コマンドの実行結果が下記のように"ajp-listener-1" が存在する場合、外部Webサーバを使用する設定になっているため、下記の手順に従い設定を行ってください。
    "ajp-listener-1" が存在しない場合、既に内部Webサーバを使用する設定になっているため、以降の作業は不要です。[b. ドメインの停止]に進んでください。
    server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2,ajp-listener-1
  5. ドメインの設定変更

    外部Webサーバを利用する設定から、Javaベースの内蔵Webサーバを利用する設定に変更します。
    以下のコマンドを実行してください。

    HTTPのみ使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-1
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=true
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=false
              
    HTTPSのみ使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-2
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=false
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=true
              
    HTTPとHTTPSを使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=true
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=true
              
    共通設定
    otxadmin> set server.internal-lifecycle-module.WebServerService.enabled=false
    otxadmin> set server.network-config.network-listeners.network-listener.ajp-listener-1.enabled=false
    otxadmin> logout
    otxadmin> exit
              

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

    連携設定を行うドメインが複数存在する場合は、ドメインごとに [a. WebOTXドメインへの内部Webサーバ利用の設定]を行ってください。
b. ドメインの停止

先の設定情報は、WebOTXサービスを再起動した後に WebOTXドメインで認識されて動作します。

  1. 設定の対象となるドメインを停止します。 停止させるためには、Administrator権限でログインしてサービスマネージャから次のサービスを停止します。
    WebOTX AS Agent Service
    運用管理コマンドでドメインを停止する場合は、以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    otxadmin> stop-domain <ドメイン名>
    otxadmin> logout
    otxadmin> exit
    

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

Webコンテナ外部のWebサーバを利用する場合

WebOTX ASでは、HTTP/HTTPS サービスに対して、サーブレットやJSPが動作する機能層のWebコンテナと、WebOTXの外部で動作する Web サーバとを連携させることができます。 サポートするWebサーバは、次のとおりです。

上記以外の「Webコンテナ内蔵のWebサーバ」を利用する場合は[Webコンテナ内蔵型のWebサーバを利用する場合]に戻ってください。

それぞれの Web サーバでサポートする OS は表 2.3.1.4-1 のようになります。

Caution
アドバンスドモードでIISと連携する場合、WebコンテナとWebサーバ間の連携モードはAJPプロトコルを利用してください。

表2.3.1.4-1
Webコンテナの動作モード Webサーバ Windows (x86) Windows (x64)
スタンダードモード WebOTX Webサーバ 2.2
WebOTX Webサーバ 2.4
Apache HTTP Server 2.2
Apache HTTP Server 2.4
Microsoft Internet Information Services
(IIS)
アドバンスドモード WebOTX Webサーバ 2.2
WebOTX Webサーバ 2.4
Apache HTTP Server 2.2
Apache HTTP Server 2.4
Microsoft Internet Information Services
(IIS)

※ 表中の記号の意味は「○」はサポートする、「-」はサポートしない

連携させることにより、HTTP/HTTPS サービスは外部 Web サーバとして公開し、HTTPリクエストがサーブレットのコンテキストであった場合は、外部 Web サーバが WebOTX AS 内部の Web コンテナへリクエストを転送して、Web コンテナで処理するようになります。

このような構成をとる場合、WebコンテナとWebサーバの連携設定を行なう必要があります。
この設定は、ご利用の環境により異なります。 次の表を参照して、必要な設定作業を確認してください。

表2.3.1.4-2
利用するWebサーバ WebコンテナとWebサーバのインストールマシン 必要な作業
WebOTX Webサーバ 同一 スタンダードモードまたはアドバンスドモードでAJPリスナを使用するときに 8099 以外のポート番号を利用される場合 e. を実施。
別々 Webコンテナ動作マシンでは、WebOTX内蔵型のJavaベースのWebサーバを使用するようにインストールした場合のみ、下記 a.、b.を実施。
Webサーバ動作マシンでは、下記 c.、d.、e.を実施。
Microsoft Internet Information Services
(IIS)
同一 下記 a.〜e.を実施。
別々 Webコンテナ動作マシンでは、下記 a.、b.を実施。
Webサーバ動作マシンでは、下記 c.、d.、e.を実施。
Apache HTTP Server 同一 下記 a.、b.、d.、e.を実施。
別々 Webコンテナ動作マシンでは、下記 a.、b.を実施。
Webサーバ動作マシンでは、下記 c.、d.、e.を実施。

以降は、WebコンテナとWebサーバの連携設定を説明しています。 ご利用の環境に合わせて、必要な設定作業を行ってください。

Caution
Webコンテナの環境設定には、注意事項があります。作業を開始する前に必ず、 [注意制限事項 > 3. Webコンテナ > 3.1. 注意事項 > 3.1.1. 環境設定] を確認してください。

a. WebOTXドメインへの外部Webサーバ連携の設定

インストール時に、WebOTX Webサーバをインストールしなかった場合、 デフォルトで内蔵Webサーバが使用される設定がされています。
ここでは、内蔵Webサーバを使用する設定から、外部Webサーバを使用する設定に変更する手順について説明しています。

  1. 運用管理コマンドを起動します。

    最初に、[スタート]-[プログラム]-[WebOTX]-[運用管理コマンド]から運用管理コマンドを起動してください。

  2. 外部Webサーバを使用する設定になっているか、WebOTX内蔵Webサーバを使用する設定になっているかを確認します。
    以下のコマンドを実行してください。
    otxadmin> get server.http-service.virtual-server.server.network-listeners
    上記コマンドの実行結果が下記のようになっていた場合、内蔵Webサーバを使用する設定になっているため、下記の手順に従い設定を行ってください。
    server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2,ajp-listener-1
    実行結果が下記のようになっていた場合、既に外部Webサーバを使用する設定になっているため、[b. ドメインと外部Webサーバの停止]に進んでください。
    server.http-service.virtual-server.server.network-listeners=ajp-listener-1
  3. 設定を変更するドメインが起動していることを確認します。
    以下のコマンドを実行してください。
    otxadmin> list-domains
    停止状態の場合、以下のコマンドで起動してください。
    otxadmin> start-domain <ドメイン名>
  4. ドメインの設定変更

    Javaベースの内蔵Webサーバを利用する設定から、外部Webサーバを利用する設定に変更します。
    以下のコマンドを実行してください。

    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    otxadmin> set server.http-service.virtual-server.server.network-listeners=ajp-listener-1
    otxadmin> logout
    otxadmin> exit
    

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

    連携設定を行うドメインが複数存在する場合は、ドメインごとに [a. WebOTXドメインへの外部Webサーバ連携の設定]を行ってください。
b. ドメインと外部Webサーバの停止

先の設定情報は、WebOTXサービスを再起動した後に WebOTXドメインで認識されて動作します。

  1. まず、設定の対象となるドメインを停止します。 停止させるためには、Administrator権限でログインしてサービスマネージャから次のサービスを停止します。
    WebOTX AS Agent Service
    運用管理コマンドでドメインを停止する場合は、以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    otxadmin> stop-domain <ドメイン名>
    otxadmin> logout
    otxadmin> exit
    

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

  2. 次に、連携対象の外部Webサーバを停止操作してください。
c. 外部WebサーバへのWebOTX連携情報の設定前の作業
c.1. 外部Webサーバの種別に関わらず必要な作業

WebコンテナとWebサーバを別々のマシンで動作させる場合、 外部Webサーバ動作マシンにWebOTXをインストールしておく必要があります。 作業に先立って、外部Webサーバ動作マシンにWebOTXのインストールを行なってください。 なお、WebOTXのインストールには、WebOTXのライセンスが必要になります。

Caution
IISと連携する場合、注意事項があります。[注意制限事項 > 3. Webコンテナ > 3.1. 注意事項 > 3.1.3. Webサーバ連携 > IIS動作マシンにWebOTXをインストールしない場合]を確認してください。

c.2. 外部Webサーバの種別毎に必要な作業
d. 外部WebサーバへのWebOTX連携情報の設定

ドメインを停止した状態で、外部Webサーバに対してWebOTXと連携することを定義します。 この操作は、GUIツールを用いて行います。

  1. [スタート]-[プログラム]-[WebOTX]-[環境設定ツール]メニューを選択し、ツールを起動します。
  2. 起動された環境設定ツール画面に情報を入力して、WebコンテナとWebサーバとの連携設定を行っていきます。 複数のドメインが存在する場合、この設定はドメイン毎に設定します。

    環境設定ツール画面
    図2.3.1.4-1

    表2.3.1.4-3
    設定項目 説明
    Webコンテナの情報 ドメインディレクトリ Webサーバと連携するWebコンテナのドメインを指定します。
    ドメインの指定例を次に示します。
    C:\WebOTX\domains\domain1
    Webサーバの情報 種別 Webコンテナと連携するWebサーバの種別を選択します。
    既定値は「Internet Information Services (IIS)」です。 Apache HTTP Server 2.2やWebOTX Web Server 2.2 を使用する場合には「WebOTX Web Server 2.2 (Apache2.2)」を選択します。 Apache HTTP Server 2.4やWebOTX WebServer 2.4 を使用する場合には「WebOTX WebServer 2.4 (Apache2.4)」を選択します。
    インストールディレクトリ Webコンテナと連携するWebサーバのインストールディレクトリを指定します。
    「Internet Information Services (IIS)」を選択した場合、指定する必要はありません。 「WebOTX Web Server 2.2 (Apache2.2)」を選択した場合、${AS_INSTALL}\WebServer22 を選択してください。また、「WebOTX Web Server 2.4 (Apache2.4)」を選択した場合、${AS_INSTALL}\WebServer24 を選択してください。
    以下に 「WebOTX Web Server 2.4」を指定する場合の指定例を示します。
    C:\WebOTX\WebServer24
    連携ポート番号 WebコンテナとWebサーバとの連携に使用するポート番号を指定します。 domain1の既定値は「8099」です。
    名称 IISを使用する場合には、「IISサイト名」を指定します。
    アドバンスドモードを利用(WebOTX AS Standard/Enterprise で利用可) WebOTX AS Standard/Enterpriseの、TPモニタ上で動作する Webコンテナを利用する場合(アドバンスドモード選択時)にチェックします。
    IISと連携している場合、この連携モードに関係なく AJP プロトコル通信で連携を行うため、この項目は環境設定ツールのGUIではグレイアウトされています。
    AJPリスナ アドバンスドモード利用時、WebコンテナとWebサーバ間の連携モードにAJPプロトコルを利用する場合に指定します。
    IIOPリスナ アドバンスドモード利用時、WebコンテナとWebサーバ間の連携モードにIIOPプロトコルを利用する場合に指定します。
    Webアプリケーションのコンテキスト名動的反映オプション Webアプリケーションのコンテキスト名を、外部Webサーバに動的に反映させるかどうかのオプションを指定します。
    動的反映機能は、Webアプリケーションが配備されたことを自動的にWebOTX Web Server(Apache)などの 外部Webサーバに反映させる仕組みであり、この機能によりドメイン再起動なく新規に配備された Webアプリケーションを外部Webサーバに認識させることができます。

    動的反映有り
    常にコンテキスト名を外部Webサーバと動的に反映します。 Webアプリケーションを新規に配備した後、Webサーバを再起動する必要がありません。

    動的反映1回のみ(Webサーバ起動時に1回のみ動的反映を行う)
    Webサーバ起動後、Webアプリケーションに最初にアクセスする時、動的反映を1回だけ行います。 この場合、2回目以降のリクエストでは動的反映を行わないため、新規に配備したWeb アプリケーションを外部Web サーバに認識させるには、Webサーバの再起動が必要です。

    動的反映無し
    Webアプリケーションのコンテキスト名を手動で設定します。 本番環境のようにWebアプリケーションの配備・配備解除を頻繁に行わない環境ではこの設定を推奨します。

    Caution
    動的反映の処理では 配備されていないコンテンツに対してリクエストが来た際、そのコンテンツがWebコンテナ側にあるかどうかを リクエストのたびに問い合わせます。この処理にある程度負荷がかかるため、Webアプリケーションを 頻繁に配備・配備解除を行わない本番環境では動的反映を無効化した状態で運用することで負荷を低減することが出来ます。

  3. <OK>ボタンを押下して設定を完了すると、Webコンテナの各種定義ファイル、および Webサーバの設定ファイルに設定情報を反映します。 <キャンセル>ボタンを押下すると反映せずにツールを終了します。
e. 外部WebサーバへのWebOTX連携情報の設定後の作業
e.1. 外部Webサーバの種別に関わらず必要な作業

Webコンテナが動作するマシンと、Webサーバが動作するマシンが別マシンである場合、または、スタンダードモードでWebコンテナとWebサーバの連携ポートが 8099 以外の場合、下記の手順に従い変更してください。

e.2. 外部Webサーバの種別毎に必要な作業

2.3.1.5. マシンの再起動

インストール後の作業で行った設定を認識させるために、マシンを再起動してください。ただし、カスタムセットアップでインストール内容をデフォルトから変更した場合は、マシンを再起動せずに次節へ進んでください。

2.3.2. Windows (WebOTX AS) カスタムセットアップで追加した機能の設定

2.3.2.1. 画面テンプレートプラグインの環境設定(対象: Standard/Enterpriseで 画面テンプレートプラグインを選択時)

[スタート]-[プログラム]-[WebOTX]-[画面テンプレートプラグイン]-[環境設定]

Webサーバの情報やトレース情報を設定後、「OK」ボタンを押してください。

画面テンプレート環境設定画面
図2.3.2.1-1

設定項目について次に説明します。

表2.3.2.1-1
設定項目 説明
ドメインの情報 ドメインディレクトリ 使用するドメインを設定してください。
Webサーバ(IIS)の情報
ドキュメントルートディレクトリ 画面テンプレートと連携するIISのドキュメントルートディレクトリを設定してください。
IISの既定のWebサーバの情報を自動的に取得し、表示します。既定のWebサーバをご使用になる場合には、変更の必要はありません。
サーバディレクトリ SCRIPTSディレクトリを設定してください。存在しない場合には、前もってディレクトリを作成しておく必要があります。
トレース情報 トレースレベル 画面テンプレート プラグインモジュールで採取するトレースのレベルを以下の中から設定してください。既定値は「エラーのみ」です。
  • エラーのみ
  • エラー、警告メッセージ
  • エラー、警告、情報メッセージ
  • すべて(デバッグレベル)
トレース最大ファイルサイズ トレースファイルの最大サイズをKB単位で指定します。 0以外を指定した場合、出力するトレースのファイルサイズが指定サイズに達すると、ファイルの先頭から書き出しを行います。 0を指定した場合、ファイルサイズのチェックを行いません。 既定値は「1024」KBです。
トレース出力ディレクトリ トレースファイルの出力先ディレクトリが表示されます。
<ドメインディレクトリ>\logs 固定
アップロードサイズ アップロードサイズ上限値 アップロードするファイルサイズの上限値を設定してください。
0を指定した場合、制限なしとなります。
既定値は「0」KB(制限なし)です。

 

2.3.2.2. WebサーバへのMIME定義追加(対象: EnterpriseでDownload Contents を選択時)

セットアップ中にDownload Contents を選択した場合は、Webサーバ(IIS を使用している場合)に次のMIME定義を追加する必要があります。

表2.3.2.2-1
MIMEの種類拡張子
application/x-wtd wtd
application/octet-stream gc1※1
application/octet-stream tlb※1

※1: 拡張子「gc1」と「tlb」の定義は、CORBAゲートウェイまたは、EJBゲートウェイ利用時に必要です。

IIS 7 に対して上記のMIME定義を追加する手順例を示します。

  1. [コントロールパネル]-[管理ツール]-[インターネット インフォメーション サービス(IIS) マネージャ] を開きます。
  2. [サイト]-[Default Web Site] を選択して、[機能ビュー] から [MIMEの種類] を開きます。
  3. 操作の[追加] をクリックして、[MIMEの種類の追加] ダイアログの [ファイル名の拡張子]、[MIMEの種類] に、それぞれ上の表にある値を設定します。

WebOTX Webサーバを使用する場合、拡張子は定義済ですので設定作業は必要ありません。
それ以外のWebサーバを使用する場合は、使用するWebサーバのマニュアルを参考に設定してください。

2.3.2.3. Webサーバへの仮想ディレクトリ定義追加(対象: Enterprise でDownload Contentsを選択時)

セットアップ中にDownload Contentsを選択した場合は、WebサーバでDownload Contentsのインストールディレクトリ内容を公開するために、仮想ディレクトリを設定します。

ここでは、WebOTX Webサーバを使用する場合の設定手順を示します。※1
それ以外のWebサーバを使用する場合は、使用するWebサーバのマニュアルを参考に設定してください。

  1. ${INSTANCE_ROOT}\config\WebServer\httpd.confファイルをエディタで開きます。
  2. 次の記述を追加します。
    #Webサーバ 2.4の場合
    Alias /WebOTX/ "<WebOTX Download Contentsインストールフォルダ>/"
    <Directory "<WebOTX Download Contentsインストールフォルダ>">
        Require all granted
    </Directory>
    
    #Webサーバ 2.2の場合
    Alias /WebOTX/ "<WebOTX Download Contentsインストールフォルダ>/"
    <Directory "<WebOTX Download Contentsインストールフォルダ>">
        Allow from all
    </Directory>
    
    ※1: WebOTX Application Server Enterpriseのインストール時に作成したユーザドメインに関しては定義追加済ですので、設定作業は必要ありません。
    (インストール後に作成したユーザドメインに関しては定義追加が必要です)

2.3.2.4. Working Domain Coordinatorのセットアップ(対象: Enterprise でWorking Domain Coordinatorを選択した場合)

Working Domain Coordinatorの機能を利用するために必要なセットアップを行います。

  1. [スタート]-[プログラム]-[アクセサリ]-[コマンドプロンプト]を起動し、次のコマンドを入力します。
    > cd /d ${AS_INSTALL}\wowdc\bin
    > wdcsetup.bat #1 #2 #3 #4
    

    wdcsetup.batの引数には以下を指定してください。
    引数は全てが既定値の場合のみ指定を省略することができます。

    表2.3.2.5-1
    引数説明既定値
    1管理者ユーザadmin
    2管理者パスワードadminadmin
    3管理ドメインのポート番号6202
    4clusterドメインのポート番号6272※1

    ※1: Enterprise (クラスタ機能のみインストール)を選択した場合は、インストール完了後にポート番号6212でclusterドメインが作成されていますので、引数4に6212を指定してください。

  2. [スタート]-[プログラム]-[WebOTX]-[運用管理コマンド]を起動し、次のコマンドを実行してclusterドメインが追加されていることを確認します。
    otxadmin> list-domains
  3. clusterドメインを以下のコマンドを実行して起動します。
    otxadmin> start-domain cluster
  4. [ 4. 動作確認 > 4.1. Windows ] で説明される方法にしたがって、clusterドメインの動作状態を確認してください。

Working Domain CoordinatorとBIG-IPの連携機能を利用する場合は、以下のセットアップを行ってください。セットアップには、Java SDKのセキュリティツールであるkeytoolを利用します。

  1. clusterドメインを以下のコマンドを実行して停止します。
    otxadmin> stop-domain cluster
  2. サーバ証明書は、BIG-IPマシンの次のディレクトリに配置されています。
    このファイルを取得し、Working Domain Coordinatorの稼動するマシンへコピーしてください。
    /config/httpd/conf/ssl.crt/server.crt

  3. [スタート]-プログラム]-[アクセサリ]-[コマンドプロンプト]を起動し、次のコマンドを入力します。
    途中で、「この証明書を信頼しますか? [no]:」と確認を求められるので、「yes」と入力してください。
    > cd /d ${AS_INSTALL}\domains\<domain_dir>\config
    > ${JAVA_HOME}\bin\keytool -v -import -trustcacerts -alias wdc_bigip -keystore cacerts.jks -storepass changeit -file <BIG-IPマシンより取得したserver.crtファイルのパス>
  4. clusterドメインを以下のコマンドを実行して起動します。
    otxadmin> start-domain cluster
  5. [ 4. 動作確認 > 4.1. Windows ] で説明される方法にしたがって、clusterドメインの動作状態を確認してください。

これらの作業完了後[ 2.3.6. データベースを使用するための準備作業 (Java) ]に進んでください。

2.3.2.5. マシンの再起動

インストール後の作業で行った設定を認識させるために、マシンを再起動してください。

2.3.3. Windows (WebOTX Client)

Windows版のWebOTX Clientをインストールした後に行う作業はありません。

2.3.4. HP-UX、Linux 共通設定

HP-UX、Linux でWebOTX AS Express/Standard/Enterprise をインストールした場合、次の作業を行います。

「インストール」の作業を終えた現在、まだWebOTXのサービスは起動していない状態にあります。 ここからの作業は、サービスが停止している最中に行うものと、それらの作業を完了した後にサービスを起動させた状態で行うものがあります。

ここでの作業は全て、rootユーザで行います。 rootユーザでログインしていることを確認してください。

Caution
Ubuntuはデフォルト設定の場合、rootユーザでログインすることができません。そのため、root権限が必要なmount/umountコマンドやサービス起動/停止等を行う場合、以下の何れかの方法で実行してください。
※ログインユーザは事前にsudo実行権を付与されている必要があります。

2.3.4.1. TPモニタの有効化(対象: Standard/Enterpriseをインストールした場合)STDENT

  1. WebOTX実行環境初期化シェルスクリプトの実行

    V9からWebOTX Application Server Standard/Enterpriseのインストール成功後、インストールスクリプト(WOINST.SH)にてWebOTX実行環境初期化シェルスクリプトを実行するようになりました。
    インストールスクリプトにてWebOTX実行環境初期化シェルスクリプトの実行に成功した場合、以下のメッセージが画面に表示されます。

    WebOTXinit94 start successful.

    上記メッセージが表示された場合、本項の以降の作業は不要です。
    ドメイン生成エラー等でインストールスクリプトが異常終了し、手動でドメインを再作成した場合は、マシンを再起動するか、WebOTX実行環境初期化シェルスクリプトを実行する必要があります。 スクリプトの実行は、rootユーザで行う必要があります。

    memo
    このスクリプトは、OSブート時に開始スクリプトが実行され、シャットダウン時に終了スクリプトが実行されます。 そのため、通常は利用者が明示的に実行する必要はありません。 また、スクリプトはマシンが稼動中に1度のみ実行されるべき処理を含みます。 したがって、1度実行した後は、手動で呼び出すことはしないようにしてください。

    HP-UX)

    root> /sbin/init.d/WebOTXinit94 start

    Linux)

    RHEL 5/6(SysVinit)の場合:

    root> /etc/init.d/WebOTXinit94 start

    RHEL 7の場合(systemd)の場合:

    root> systemctl start WebOTXinit94

2.3.4.2. Webサーバの動作設定(対象: Webサーバを利用する場合)

Webコンテナ内蔵型のWebサーバを利用する場合

WebOTX ASでは、HTTP/HTTPS サービスを、サーブレットやJSPが動作する機能層のWebコンテナ内部で動作させることができます。
それ以外のWebコンテナ外部のWebサーバを利用する場合は[Webコンテナ外部のWebサーバを利用する場合]に進んでください。

a. WebOTXドメインへの内部Webサーバ利用の設定

インストール時に、WebOTX Webサーバをインストールした場合、 デフォルトでWebOTX Webサーバが使用される設定がされています。
ここでは、WebOTX Webサーバを使用する設定から、内部Webサーバを使用する設定に変更する手順について説明しています。

  1. 運用管理コマンドを起動します。
    root> /opt/WebOTX/bin/otxadmin
  2. ドメインが起動していることを確認します。
    以下のコマンドを実行してください。
    otxadmin> list-domains
    停止状態の場合、以下のコマンドで起動してください。
    otxadmin> start-domain <ドメイン名>
  3. ドメインにログインします。
    以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    
  4. 外部Webサーバを使用する設定になっているか、WebOTX内蔵Webサーバを使用する設定になっているかを確認します。
    以下のコマンドを実行してください。
    otxadmin> get server.http-service.virtual-server.server.network-listeners
    上記コマンドの実行結果が下記のように"ajp-listener-1" が存在する場合、外部Webサーバを使用する設定になっているため、下記の手順に従い設定を行ってください。
    "ajp-listener-1" が存在しない場合、既に内部Webサーバを使用する設定になっているため、以降の作業は不要です。[b. ドメインの停止]に進んでください。
    server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2,ajp-listener-1
  5. ドメインの設定変更

    外部Webサーバを利用する設定から、Javaベースの内蔵Webサーバを利用する設定に変更します。
    以下のコマンドを実行してください。

    HTTPのみ使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-1
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=true
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=false
              
    HTTPSのみ使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-2
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=false
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=true
              
    HTTPとHTTPSを使用する場合
    otxadmin> set server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-1.enabled=true
    otxadmin> set server.network-config.network-listeners.network-listener.http-listener-2.enabled=true
              
    共通設定
    otxadmin> set server.internal-lifecycle-module.WebServerService.enabled=false
    otxadmin> set server.network-config.network-listeners.network-listener.ajp-listener-1.enabled=false
    otxadmin> logout
    otxadmin> exit
              

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

    連携設定を行うドメインが複数存在する場合は、ドメインごとに [a. WebOTXドメインへの内部Webサーバ利用の設定]を行ってください。
b. ドメインの停止

先の設定情報は、WebOTXサービスを再起動した後に WebOTXドメインで認識されて動作します。

  1. 設定の対象となるドメインを停止します。 ドメインを停止する場合は、運用管理コマンドで、以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    otxadmin> stop-domain <ドメイン名>
    otxadmin> logout
    otxadmin> exit
    

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

Webコンテナ外部のWebサーバを利用する場合

WebOTX ASでは、HTTP/HTTPS サービスに対して、サーブレットやJSPが動作する機能層のWebコンテナと、WebOTXの外部で動作する Web サーバとを連携させることができます。 サポートするWebサーバは、次のとおりです。

上記以外の「Webコンテナ内蔵のWebサーバ」を利用する場合は[Webコンテナ内蔵型のWebサーバを利用する場合]に戻ってください。

それぞれの Web サーバでサポートする OS は表 2.3.4.2-1 のようになります。

Caution
アドバンスドモードでは、WebOTX Webサーバと Apache HTTP Server のみサポートしています。

表2.3.4.2-1
Webコンテナの動作モード Webサーバ Linux (x64) HP-UX (IPF)
スタンダードモード WebOTX Webサーバ 2.2
WebOTX Webサーバ 2.4
Apache HTTP Server 2.2
Apache HTTP Server 2.4
アドバンスドモード WebOTX Webサーバ 2.2
WebOTX Webサーバ 2.4
Apache HTTP Server 2.2
Apache HTTP Server 2.4

※ 表中の記号の意味は「○」はサポートする、「-」はサポートしない
※ WebOTX AS ExpressがサポートするWebコンテナの動作モードはスタンダードモードのみです。

連携させることにより、HTTP/HTTPS サービスは外部 Web サーバとして公開し、HTTPリクエストがサーブレットのコンテキストであった場合は、外部 Web サーバが WebOTX AS 内部の Web コンテナへリクエストを転送して、Web コンテナで処理するようになります。

このような構成をとる場合、WebコンテナとWebサーバの連携設定を行なう必要があります。
この設定は、ご利用の環境により異なります。 次の表を参照して、必要な設定作業を確認してください。


表2.3.4.2-2
利用するWebサーバ WebコンテナとWebサーバのインストールマシン 必要な作業
WebOTX Webサーバ 同一 デフォルトのポート番号(8099)を利用する場合、本節の作業は不要。
スタンダードモードまたはアドバンスドモードでAJPリスナを使用するときに 8099 以外のポート番号を利用される場合のみ e. を実施。
別々 Webコンテナ動作マシンでは、WebOTX内蔵型のJavaベースのWebサーバを使用するようにインストールした場合のみ、下記 a.、b.を実施。
Webサーバ動作マシンでは、下記 c.、d.、e.を実施。
Apache HTTP Server 同一 下記 a.、b.、d.、e.を実施。
別々 Webコンテナ動作マシンでは、下記 a.、b.を実施。
Webサーバ動作マシンでは、下記 c.、d.、e.を実施。

以降は、WebコンテナとWebサーバの連携設定を説明しています。 ご利用の環境に合わせて、必要な設定作業を行ってください。

Caution
Webコンテナの環境設定には、注意事項があります。作業を開始する前に必ず、 [注意制限事項 > 3. Webコンテナ > 3.1. 注意事項 > 3.1.1. 環境設定] を確認してください。

a. WebOTXドメインへの外部Webサーバ連携の設定

インストール時に、WebOTX Webサーバをインストールしなかった場合、 デフォルトで内蔵Webサーバが使用される設定がされています。
ここでは、内蔵Webサーバを使用する設定から、外部Webサーバを使用する設定に変更する手順について説明しています。

  1. 運用管理コマンドを起動します。
    root> /opt/WebOTX/bin/otxadmin
  2. 設定を変更するドメインが起動していることを確認します。
    以下のコマンドを実行してください。
    otxadmin> list-domains
    停止状態の場合、以下のコマンドで起動してください。
    otxadmin> start-domain <ドメイン名>
  3. 外部Webサーバを使用する設定になっているか、WebOTX内蔵Webサーバを使用する設定になっているかを確認します。
    以下のコマンドを実行してください。
    otxadmin> get server.http-service.virtual-server.server.network-listeners
    上記コマンドの実行結果が下記のようになっていた場合、内蔵Webサーバを使用する設定になっているため、下記の手順に従い設定を行ってください。
    server.http-service.virtual-server.server.network-listeners=http-listener-1,http-listener-2,ajp-listener-1
    実行結果が下記のようになっていた場合、既に外部Webサーバを使用する設定になっているため、[b. ドメインと外部Webサーバの停止]に進んでください。
    server.http-service.virtual-server.server.network-listeners=ajp-listener-1
    連携設定を行うドメインが複数存在する場合は、ドメインごとに [a. WebOTXドメインへの外部Webサーバ連携の設定]を行ってください。

  4. ドメインの設定変更

    Javaベースの内蔵Webサーバを利用する設定から、外部Webサーバを利用する設定に変更します。
    以下のコマンドを実行してください。

    otxadmin> set server.http-service.virtual-server.server.network-listeners=ajp-listener-1
    otxadmin> logout
    otxadmin> exit
    
b. ドメインと外部Webサーバの停止

先の設定情報は、WebOTXサービスを再起動した後に WebOTXドメインで認識されて動作します。

  1. まず、設定の対象となるドメインを停止します。
    ドメインを停止する場合は、運用管理コマンドで、以下のコマンドを実行してください。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    otxadmin> stop-domain <ドメイン名>
    otxadmin> logout
    otxadmin> exit
    

    (*) user の既定値は、adminpassword の既定値は、adminadminport の既定値は、6212 です。

  2. 次に、連携対象の外部Webサーバを停止操作してください。
c. 外部WebサーバへのWebOTX連携情報の設定前の作業
c.1. 外部Webサーバの種別に関わらず必要な作業

WebコンテナとWebサーバを別々のマシンで動作させる場合、 外部Webサーバ動作マシンにWebOTXをインストールしておく必要があります。 作業に先立って、外部Webサーバ動作マシンにWebOTXのインストールを行なってください。 なお、WebOTXのインストールには、WebOTXのライセンスが必要になります。

Caution
IISと連携する場合、注意事項があります。[注意制限事項 > 3. Webコンテナ > 3.1. 注意事項 > 3.1.3. Webサーバ連携 > IIS動作マシンにWebOTXをインストールしない場合]を確認してください。

c.2. 外部Webサーバの種別毎に必要な作業

外部Webサーバ種別毎で、必要な作業はありません。

d. 外部WebサーバへのWebOTX連携情報の設定

ドメインを停止した状態で、外部Webサーバに対してWebOTXと連携することを定義します。 この操作は、シェル・スクリプトを用いて行います。

  1. WebOTXのインストールディレクトリ/binディレクトリへ移動します。
    root> cd /opt/WebOTX/bin
  2. ./setconf.sh と入力し環境設定ツールを起動してください。
    root> ./setconf.sh
  3. スクリプトの指示にしたがって、必要な情報を設定してください。
    Please enter a domain directory.
    [/opt/WebOTX/domains/domain1]
    

    外部Webサーバと連携するWebコンテナが動作するドメインのディレクトリを指定してください。
    (既定値: ${AS_INSTALL}/domains/domain1)

    Please select Web server.[1]
       1. WebOTX Web Server 2.2(Apache2.2)
       2. WebOTX Web Server 2.4(Apache2.4)
    
    Webサーバの種類を指定してください。
    Please enter Web server installation directory.
    [/opt/WebOTX/WebServer24]
    

    連携する外部Webサーバのインストールディレクトリを指定します。

    Would you like to select Advanced Mode? (y/n) [default n]
    You can select Advanced Mode in WebOTX Standard/Enterprise.
    

    Webコンテナの動作モードを選択してください。 アドバンスドモードの場合は「y」を、スタンダードモードの場合は「n」を指定してください。 WebOTX AS Standard/Enterprise のインストールオプションで Webコンテナ動作モードにアドバンスドモードを選択した場合は「y」を指定してください。
    WebOTX AS Express を使用する場合や、WebOTX AS Standard/Enterprise のインストールオプションでスタンダードモードを選択した場合は「n」を指定してください。
    WebOTX AS Express の場合)
    (既定値: n)
    WebOTX AS Standard/Enterpriseの場合)
    (既定値: y)

    [アドバンスドモードを指定した場合]

    Please enter protocol type for communication with WebOTX Web Container.[1]
       1. Protocol type is ajp.
       2. Protocol type is iiop.
    

    WebコンテナとWebサーバ間の連携モードを指定してください。 AJPプロトコル通信を行う場合は「1」を、IIOPプロトコル通信を行う場合は「2」を指定してください。

    [スタンダードモードまたはアドバンスドモードでAJPプロトコルを指定した場合]

    Please enter port for communication with WebOTX Web Container.[8099]
    

    外部WebサーバとWebコンテナとの連携に使用するポート番号を指定してください。
    (*) この項目は、前項のWebコンテナ動作モードの選択で「n」を指定した場合にのみ表示されます
    Webサーバがクライアントからのリクエストを受け付けるポート番号ではありません。
    (domain1の既定値: 8099)

    Please select context name dynamic reflection option of Web application.[1]
       1. Dynamic reflection option is on. 
       2. Dynamic reflection option is once.
           (Note: When a Web server starts, you do dynamic reflection once. 
            When you deployed a Web application, you have to reboot a Web server.) 
       3. Dynamic reflection option is off.
    

    Webアプリケーションのコンテキスト名動的反映オプションを選択してください。
    動的反映機能は、Webアプリケーションが配備されたことを自動的にWebOTX Web Server(Apache) などの 外部Webサーバに反映させる仕組みであり、この機能によりドメイン再起動なく新規に配備された Webアプリケーションを外部Webサーバに認識させることができます。

    「1. Dynamic reflection option is on.」を選択した場合、動的反映が常に有効になります。
    「2. Dynamic reflection option is once.」を選択した場合、Webサーバ起動時に1回のみ動的反映が行われます。
    「3. Dynamic reflection option is off.」を選択した場合、動的反映処理は行われません。

    Caution
    動的反映の処理では配備されていないコンテンツに対してリクエストが来た際、 そのコンテンツがWebコンテナ側にあるかどうかをリクエストのたびに問い合わせます。 この処理にある程度負荷がかかるため、Webアプリケーションを 頻繁に配備・配備解除を行わない本番環境では動的反映を無効化した状態で運用することで負荷を低減することが出来ます。

  4. 必要な情報の入力が完了すると、確認画面を表示します。
    The following information has been set.
      WebOTX Web Container installation directory:/opt/WebOTX
      Domain directory:/opt/WebOTX/domains/domain1
      Web server:WebOTX Web Server 2.4(Apache2.4)
      Web server installation directory:/opt/WebOTX/WebServer24
      Port for communication with WebOTX Web Container:8099
      Web server plugin dynamic reflection option:on
      Would you like to continue?(y/n)
    

    情報に誤りがなければ「y」を入力して環境設定し、 誤りがある場合は「n」を入力して処理を中断してください。 中断した場合は、再度 setconf.sh を起動して環境設定を行ってください。

  5. 次のメッセージが出力されれば環境設定が完了します。
    Web server setting is completed.

    途中でエラーになった場合は、再度 setconf.sh を実行してください。

e. 外部WebサーバへのWebOTX連携情報の設定後の作業

Webコンテナが動作するマシンと、Webサーバが動作するマシンが別マシンである場合、または、スタンダードモードでWebコンテナとWebサーバの連携ポートが 8099 以外の場合、下記の手順に従い変更してください。

2.3.4.3. rsyslog または syslog-ng を利用して syslog へのログ出力を行うための設定

UNIX 環境において、syslog へのログ出力に rsyslog または syslog-ng を利用する場合、既定の状態ではrsyslog または syslog-ng のデーモンプロセスへの UDP 接続が可能な設定ではありません。WebOTX_AS_Agent をプレフィックスに持つ WebOTX Application Server のログ出力では、デーモンプロセスに対しUDP 接続する必要があるため、既定の状態では syslog にログを出力することができません。

rsyslog または syslog-ng を利用する場合、[ 高度な管理と運用サイクルガイド > 4. 監視 > 4.2. ログ監視 > 4.2.2. syslog ] に記載した手順を実施して、UDP 接続の待ち受けを有効化してください。

なお、Red Hat Enterprise Linux 6 Server (6.1 以降) では rsyslog が既定で利用されます。 該当のOS環境をご利用の場合は有効化の手順を必ず実施してください。

2.3.4.4. ログ出力のロケール設定変更

UNIX 環境において、WebOTX Application Server のログ出力には対象マシンにおけるデフォルトのロケールが使用されます。
RHEL 7 の場合はlocalectlコマンド、それ以外の場合はlocaleコマンドにてデフォルトのロケールを確認できます。
WebOTX Application Server のログ出力にデフォルトとは異なるロケールを使用する場合、ドメイン共通環境変数設定ファイル ${AS_INSTALL}/config/asenv.conf に以下の記載例のように環境変数 LANGの設定を追加してください。
※デフォルトのロケールをそのまま使用する場合、本節の作業は不要です。

[英語出力の場合]
LANG=C
export LANG

[日本語出力(Linux)の場合]
LANG=ja_JP.UTF-8
export LANG

[日本語出力(HP-UX)の場合]
LANG=ja_JP.utf8
export LANG
CautionSTDENT
TPシステムが出力するメッセージ(TPSxx-xxxxxの形式)は、ロケールの設定にかかわらず英語出力のみです。

※ドメインが起動している場合、設定変更を反映するためドメインの再起動を行ってください。

2.3.4.5. LinuxにおいてRMI通信でリモート接続を利用するための設定 (対象: Linuxを利用している場合)

サーバOSとしてLinuxを利用している場合、次の設定がされている環境ではRMI通信によるリモート接続が行えないため、 運用管理ツールからドメインに接続できないという問題が発生します。

RMI通信によるリモート接続が行えなくなる場合

サーバマシンに次の設定がされている場合、RMI通信によるリモート接続ができなくなります。


リモート接続を行えるようにするための設定

上記の条件に当てはまる場合、リモート接続を可能とするために、 /etc/hostsファイルから「ホスト名」を削除して、127.0.0.1 に対応するのは localhost のみとしてください。/etc/hostsファイルを編集した後は、WebOTXのサービスを再起動して設定を反映させてください。

  1. WebOTXのサービスを停止します。

    RHEL 5/6(SysVinit)の場合:

    # /etc/init.d/WOAgentSvc94 stop

    RHEL 7の場合(systemd)の場合:

    # systemctl stop WOAgentSvc94
  2. WebOTXのサービスを起動します。

    RHEL 5/6(SysVinit)の場合:

    # /etc/init.d/WOAgentSvc94 start

    RHEL 7の場合(systemd)の場合:

    # systemctl start WOAgentSvc94
/etc/hostsファイルを編集できない場合

/etc/hostsファイルを修正することが出来ない場合、WebOTXがインストールされているマシン上で次の設定を行って下さい。

  1. WebOTXサービスを起動します。rootユーザでログインして以下のコマンドを実行します。

    RHEL 5/6(SysVinit)の場合:

    # /etc/init.d/WOAgentSvc94 start

    RHEL 7の場合(systemd)の場合:

    # systemctl start WOAgentSvc94
  2. 運用管理コマンドを立ち上げます。
    # /opt/WebOTX/bin/otxadmin
  3. ドメインが起動できていることを確認します。
    otxadmin> list-domains
    次のように表示されれば、起動できています。
    List of domains:
    domain1 running
    WebOTXAdmin running
    
  4. 運用管理コマンドで管理ドメイン(WebOTXAdmin)にログインします。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    (*) user の既定値は、admin、password の既定値は、adminadmin 、 port の既定値は、6202 です。

  5. 管理ドメイン(WebOTXAdmin)に対して、次のコマンドでJavaシステムプロパティを設定します。
    otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名>
  6. ユーザドメイン(domain1)に対しても、同じようにJavaシステムプロパティを設定します。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    (*) user の既定値は、admin、password の既定値は、adminadmin 、 port の既定値は、6212 です。
    otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名>
  7. WebOTXのサービスを再起動します。

    RHEL 5/6(SysVinit)の場合:

    # /etc/init.d/WOAgentSvc94 stop
    # /etc/init.d/WOAgentSvc94 start
    

    RHEL 7の場合(systemd)の場合:

    # systemctl stop WOAgentSvc94
    # systemctl start WOAgentSvc94
    
  8. [ 4. 動作確認 > 4.2. HP-UX、Linux ] で説明される方法にしたがって、動作確認を行って下さい。
Caution
ドメインを新たに作成する場合は、作成したドメインに対しても上記のJavaシステムプロパティを設定してください。

2.3.4.6. 互換シンボリックリンクについて

UNIX版では複数バージョンインストールのサポートに伴い、本バージョンからインストール時に/usr/lib配下のシンボリックリンクの作成を行わなくなりました。
そのため、C++アプリケーションからTransactionサービスを利用する場合に必要となるシンボリックを作成/削除する機能を提供しています。
詳細は[製品構成と提供機能 > 3. 提供機能 > 3.11. インストール/アンインストール > 3.11.3. 複数バージョンインストール > 3.11.3.6. Transactionサービス ]を確認してください。
※C++アプリケーションからTransactionサービスを利用していない場合、本節の作業は必要ありません。

互換シンボリックリンクの作成/削除は、インストール完了後に互換シンボリックリンク管理スクリプト(MNGCMPSL.SH)を使用して行います。

Caution
互換シンボリックリンク管理スクリプト利用時の留意点に関しては [製品構成と提供機能 > 3. 提供機能 > 3.11. インストール/アンインストール > 3.11.3. 複数バージョンインストール > 3.11.3.2. 互換シンボリックリンク管理スクリプト ]を参照してください。
2.3.4.6.1. 互換シンボリックリンクの作成

互換シンボリックリンクの作成手順は次のとおりです。
※事前に対象マシンにインストールされている全バージョンのWebOTXのサービスが停止していることを確認してください。

  1. ログイン名 root でログインします。
    login: root
  2. 以下コマンドでディレクトリを移動してください。
    root> cd /opt/share.nec/bin
    Caution
    Clientのみインストールしている場合、上記ディレクトリは存在しません。
    インストールに使用したWebOTX Mediaに格納されているWOINST/MNGCMPSL.tarを対象マシンのディレクトリに展開してください。
  3. 互換シンボリックリンク管理スクリプトを起動してください。
    root> ./MNGCMPSL.SH
  4. スクリプトの指示にしたがって、互換シンボリックリンクの作成「1」を選択してください。
    Compatible symbolic link management script of WebOTX V9.4 products.
    
    Please select one of the following function:
    
       1. Make compatible symbolic links
       2. Remove compatible symbolic links
      99. Cancel
    
  5. 互換シンボリックリンクの作成開始確認画面が表示されます。
    ******************************************************************
    * Making compatible symbolic links of WebOTX V9.4 product.       *
    * To continue, enter y. Enter q to exit. [y, q] (Default: y)     *
    ******************************************************************
    

    互換シンボリックリンクの作成を開始するには「y」を入力してください。 キャンセルするには「q」を入力してください。

    キャンセルした場合は互換シンボリックリンク管理スクリプトが終了します。 再実行する場合は、「3.」の互換シンボリックリンク管理スクリプトの実行からやり直してください。

  6. バックアップファイル(backup-slink.tar)が存在する場合、以下の確認画面が表示されます。
    Backup file of symbolic links(/opt/share.nec/bin/backup-slink.tar) exists.
    Would you like to remove it?  [y,n] (Default: n)
    
    バックアップファイルが不要であることが確認できている場合、「y」で削除を選択してください。
    バックアップファイルが必要な場合、「n」を入力して互換シンボリックリンク管理スクリプトを終了してファイルを別ディレクトリに退避してから互換シンボリックリンク管理スクリプトを再実行してください。
  7. 作成されたシンボリックリンクが以下のように表示されます。
    /usr/lib/lib***.so is created.
    /usr/lib/lib***.so is created.
    /usr/lib/lib***.so is created.
    
  8. 他バージョンのシンボリックリンクが存在する場合、バックアップファイル(backup-slink.tar)が作成され、以下のように表示されます。
    ※他バージョンのシンボリックリンクは削除されて、本バージョンのファイルへのシンボリックリンクが作成されます。
    Backup file of symbolic links(/opt/share.nec/bin/backup-slink.tar) is created.
    lrwxrwxrwx root/sys          0 yyyy-mm-dd HH:MM:SS usr/lib/lib*.so -> /opt/WebOTX/**/lib*.so
    lrwxrwxrwx root/sys          0 yyyy-mm-dd HH:MM:SS usr/lib/lib*.so -> /opt/WebOTX/**/lib*.so
    
    バックアップファイルは、互換シンボリックリンクの削除時にリストアすることが可能です。
2.3.4.6.2. 互換シンボリックリンクの削除

互換シンボリックリンクの削除手順は次のとおりです。

  1. ログイン名 root でログインします。
    login: root
  2. 以下コマンドでディレクトリを移動してください。
    root> cd /opt/share.nec/bin
    Caution
    Clientのみインストールしている場合、上記ディレクトリは存在しません。
    インストールに使用したWebOTX Mediaに格納されているWOINST/MNGCMPSL.tarを対象マシンのディレクトリに展開してください。
  3. 互換シンボリックリンク管理スクリプトを起動してください。
    root> ./MNGCMPSL.SH
  4. スクリプトの指示にしたがって、互換シンボリックリンクの削除「2」を選択してください。
    Compatible symbolic link management script of WebOTX V9.4 products.
    
    Please select one of the following function:
    
       1. Make compatible symbolic links
       2. Remove compatible symbolic links
      99. Cancel
    
  5. 互換シンボリックリンクの削除開始確認画面が表示されます。
    ******************************************************************
    * Removing compatible symbolic links of WebOTX V9.4 product.       *
    * To continue, enter y. Enter q to exit. [y, q] (Default: y)     *
    ******************************************************************
    

    互換シンボリックリンクの削除を開始するには「y」を入力してください。 キャンセルするには「q」を入力してください。

    キャンセルした場合は互換シンボリックリンク管理スクリプトが終了します。 再実行する場合は、「3.」の互換シンボリックリンク管理スクリプトの実行からやり直してください。

  6. 削除されたシンボリックリンクが以下のように表示されます。
    Remove /usr/lib/lib***.so
    Remove /usr/lib/lib***.so
    Remove /usr/lib/lib***.so
    
  7. バックアップファイル(backup-slink.tar)が存在する場合、他バージョンのシンボリックリンクのリストアを行うか確認画面が表示されます。
    Backup file of symbolic links(/opt/share.nec/v94/bin/backup-slink.tar) exists.
    Would you like to remove it?  [y,n] (Default: n)
    
    リストアを行う場合は「y」を、リストアを行わない場合は「n」を入力してください。
    ※他バージョンがインストールされたままの場合、通常はリストアを行ってください。
  8. バックアップファイル(backup-slink.tar)が存在する場合、バックアップファイル削除するか確認画面が表示されます。
    Would you like to remove backup file of symbolic links?  [y,n] (Default: y)
    
    削除する場合は「y」を、削除しない場合は「n」を入力してください。
    ※前の画面でリストアを行っていない場合、バックアップファイルが不要であることが確認できている時のみ「y」で削除を選択してください。
2.3.4.6.3. 互換シンボリックリンク一覧

互換シンボリックリンク管理スクリプトで作成するシンボリックリンクは、OS及びインストール製品により異なります。

Linux(x64)版の互換シンボリックリンク一覧は以下の通りです。

表2.3.4.6.3-1
シンボリックリンク名 AS Std/Ent Cli Dev 備考
/usr/lib64/libwotsjni71.so 作成 作成 作成
/usr/lib64/libcom.nec.so.1 作成 作成 作成
/usr/lib64/libcom.nec.so.3 作成 作成 作成
/usr/lib64/libnotscmn.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotscmn.so.9 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotsimp.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotsimp.so.9 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotscur.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotscur.so.9 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libnotscmn.so - - 作成
/usr/lib64/libnotsimp.so - - 作成
/usr/lib64/libnotscur.so - - 作成
/usr/lib64/libwotsadm.so.6 作成 - -
/usr/lib64/libwotsadm.so.8 作成 - -
/usr/lib64/libwots.so - - 作成
/usr/lib64/libcom.nec.so 作成 - -
/usr/lib64/libcomshlib.so.3 作成 - -
/usr/lib64/libcomshlib.so.5 作成 - -
/usr/lib64/librmxadisp.so.1 作成 - -
/usr/lib64/librmxadisp.so.3 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib64/libwots.so.7 作成 - -
/usr/lib64/libwots.so.9 作成 - -

HP-UX(IPF)版の互換シンボリックリンク一覧は以下の通りです。

表2.3.4.6.3-2
シンボリックリンク名 AS Std/Ent Cli Dev 備考
/usr/lib/hpux64/libcom.nec.so.2 作成 作成 作成
/usr/lib/hpux64/comlib.so.2 作成 作成 作成
/usr/lib/hpux64/libwotsjni71.so 作成 作成 作成
/usr/lib/hpux64/libnotscmn.so.6 作成 作成 *1 - *1 Transaction Service Compatibility Librariesインストール時
/usr/lib/hpux64/libnotsimp.so.6 作成 作成 *1 - *1 Transaction Service Compatibility Librariesインストール時
/usr/lib/hpux64/libnotscur.so.6 作成 作成 *1 - *1 Transaction Service Compatibility Librariesインストール時
/usr/lib/hpux64/libnotscmn.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib/hpux64/libnotsimp.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib/hpux64/libnotscur.so.7 作成 作成 *1 - *1 WebOTX Transaction Service Clientインストール時
/usr/lib/hpux64/rmxadisp.so.2 作成 作成 *1 作成 *1 WebOTX Transaction Service Clientインストール時
/usr/lib/hpux64/libcomshlib.so.3 作成 - 作成
/usr/lib/hpux64/libcomshlib.so 作成 - -
/usr/lib/hpux64/libnotscmn.so - - 作成
/usr/lib/hpux64/libnotsimp.so - - 作成
/usr/lib/hpux64/libnotscur.so - - 作成
/usr/lib/hpux64/libwots.so - - 作成
/usr/lib/hpux64/libwotsadm.so.6 作成 - -
/usr/lib/hpux64/libnotsac.so.6 作成 - -
/usr/lib/hpux64/libwotsjni61.so 作成 - -
/usr/lib/hpux64/libwotsadm.so 作成 - -
/usr/lib/hpux64/libwots.so.6 作成 - -
/usr/lib/hpux64/libwots.so.7 作成 - -

2.3.5. HP-UX、Linux カスタムセットアップで追加した機能の設定

2.3.5.1. WebサーバへのMIME定義追加(対象: Enterprise でDownload Contentsを選択時)

セットアップ中にDownload Contentsを選択した場合は、Webサーバに次のMIME定義を追加する必要があります。

表2.3.5.1-1
MIMEの種類拡張子
application/x-wtd wtd
application/octet-stream gc1※1
application/octet-stream tlb※1

※1: 拡張子「gc1」と「tlb」の定義は、CORBAゲートウェイまたは、EJBゲートウェイ利用時に必要です。

WebOTX Webサーバを使用する場合、拡張子は定義済ですので設定作業は必要ありません。
それ以外のWebサーバを使用する場合は、使用するWebサーバのマニュアルを参照してください。

2.3.5.2. Webサーバへの仮想ディレクトリ定義追加(対象: EnterpriseでDownload Contentsを選択時)

セットアップ中にDownload Contentsを選択した場合は、WebサーバでDownload Contentsのインストールディレクトリ内容を公開するために、仮想ディレクトリを設定します。

ここでは、WebOTX Webサーバを使用する場合の設定手順を示します。※1 それ以外のWebサーバを使用する場合は、使用するWebサーバのマニュアルを参照してください。

  1. /opt/WebOTX/domains/<domain_dir>/config/WebServer/httpd.confファイルをエディタで開く。
  2. 次の記述を追加する。
    #Webサーバ 2.4の場合
    Alias /WebOTX/ "/opt/WebOTX/Downloader/"
    <Directory "/opt/WebOTX/Downloader">
        Require all granted
    </Directory>
    
    #Webサーバ 2.2の場合
    Alias /WebOTX/ "/opt/WebOTX/Downloader/"
    <Directory "/opt/WebOTX/Downloader">
        Allow from all
    </Directory>
    
    ※1: インストールスクリプトによるWebOTX Application Server Enterpriseのインストール時に作成したユーザドメインに関しては定義追加済ですので、設定作業は必要ありません。
    (インストール後に作成したユーザドメインに関しては定義追加が必要です)

2.3.5.3. Working Domain Coordinatorのセットアップ(対象: EnterpriseでWorking Domain Coordinatorを選択した場合)

Working Domain Coordinatorの機能を利用するために必要なセットアップを行います。

(*)インストールするファイルのオーナーをroot以外のアカウントにした場合は、以降の root> を
そのアカウントに読み替えてください。

  1. 次のコマンドを入力します。
    root> /opt/WebOTX/wowdc/bin/wdcsetup.sh #1 #2 #3 #4

    wdcsetup.shの引数には以下を指定してください。
    引数は全てが既定値の場合のみ指定を省略することができます。

    表2.3.5.3-1
    引数説明既定値
    1管理者ユーザadmin
    2管理者パスワードadminadmin
    3管理ドメインのポート番号6202
    4clusterドメインのポート番号6272※1

    ※1: Enterprise (クラスタ機能のみインストール)を選択した場合は、インストール完了後にポート番号6212でclusterドメインが作成されていますので、引数4に6212を指定してください。

  2. 運用管理コマンドを起動します。
    root> /opt/WebOTX/bin/otxadmin
  3. 次のコマンドを実行してclusterドメインが追加されていることを確認します。
    otxadmin> list-domains
  4. clusterドメインを以下のコマンドを実行して起動します。
    otxadmin> start-domain cluster
  5. [ 4. 動作確認 > 4.2. HP-UX、Linux ] で説明される方法にしたがって、clusterドメインの動作状態を確認してください。

Working Domain CoordinatorとBIG-IPの連携機能を利用する場合は、以下のセットアップを行ってください。セットアップには、Java SDKのセキュリティツールであるkeytoolを利用します。

  1. clusterドメインを以下のコマンドを実行して停止します。
    otxadmin> stop-domain cluster
  2. サーバ証明書は、BIG-IPマシンの次のディレクトリに配置されています。
    このファイルを取得し、Working Domain Coordinatorの稼動するマシンへコピーしてください。
    /config/httpd/conf/ssl.crt/server.crt

  3. 次のコマンドを入力します。
    途中で、「この証明書を信頼しますか? [no]:」と確認を求められるので、「yes」と入力してください。
    root> cd /opt/WebOTX/domains/<domain_dir>/config 
    root> <Java SDKインストールディレクトリ>/bin/keytool -v -import -trustcacerts -alias wdc_bigip -keystore cacerts.jks -storepass changeit -file <BIG-IPマシンより取得したserver.crtファイルのパス>
  4. clusterドメインを以下のコマンドを実行して起動します。
    otxadmin> start-domain cluster
  5. [ 4. 動作確認 > 4.2. HP-UX、Linux ] で説明される方法にしたがって、clusterドメインの動作状態を確認してください。

これらの作業完了後[ 2.3.6. データベースを使用するための準備作業 (Java) ]に進んでください。

2.3.6. データベースを使用するための準備作業 (Java)

JavaアプリケーションでJDBCを使用する場合には、各データベースで次の準備作業を行ってください。 詳細については、各データベースのリファレンスマニュアルでご確認ください。

Oracle での作業 Microsoft SQL Server での作業

WebOTX AS Express/Standardは、以上で全ての作業が完了しました。

Enterpriseでは、CORBA C++アプリケーションも動作する実行基盤を提供しています。 CORBA C++アプリケーションをWebOTX AS上で動作させる場合は、次の項目に進んでください。

2.3.7. データベースを使用するための準備作業 (C++)

WebOTX AS EnterpriseでC++アプリケーションでデータベースを使用する場合には、各データベースで次の準備作業を行ってください。 詳細については、各データベースのリファレンスマニュアルでご確認ください。

Oracle での作業

2.3.8. ファイアウォールの設定に関して

ファイアウォールを設定している場合、クライアントマシンからの接続に特定のファイアウォールのブロックを解除する必要があります。詳細は[ リファレンス集 ドメイン構成・環境移行編 > 1. WebOTXの構成 > 1.5. ファイアウォールの例外設定 ] を参照してください。

2.3.9. 複数のネットワークカードを利用している場合の設定

WebOTXが動作するサーバが複数のネットワークカードを利用している場合、運用管理ツールからドメインへの接続が失敗することがあります。該当する環境を利用している場合、本項目の回避手順を実施してください。

問題の詳細

WebOTXでは、運用管理ツールからドメインに接続する際に、既定ではRMI通信を利用します。

RMI通信では、ドメインの起動時に、RMI通信用にIPアドレスとポート番号を埋め込んだスタブファイルを作成しておきます。そして、運用管理ツールを利用してクライアントから接続があった際に、作成しておいたスタブファイルをクライアントに送付します。スタブファイルを受け取ったクライアントは、スタブファイルに埋め込まれたIPアドレスとポート番号を利用してドメインと通信を行います。

WebOTXが動作するサーバに複数のネットワークカードが設定されている場合、既定では、スタブファイルに埋め込まれるIPアドレスは、いずれかのネットワークカードに設定されているIPアドレスとなります。このため、クライアントから接続できないIPアドレスがスタブファイルに埋め込まれてしまい、クライアントからの接続に失敗する問題が発生することがあります。

この問題を回避するために、次の手順を実施して、スタブファイルに埋め込むIPアドレスを明示的に指定してください。スタブファイルに埋め込むIPアドレスにクライアントが接続できるものを指定することで、クライアントから正常に接続できるようになります。

回避手順

  1. WebOTXサービスを起動します。

  2. 運用管理コマンドを立ち上げます。

  3. ドメインが起動できていることを確認します。
    otxadmin> list-domains
    次のように表示されれば、起動できています。
    List of domains:
    domain1 running
    WebOTXAdmin running
    
  4. 運用管理コマンドで管理ドメイン(WebOTXAdmin)にログインします。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    
    (*) user の既定値は、admin、password の既定値は、adminadmin 、 port の既定値は、6202 です。

  5. 管理ドメイン(WebOTXAdmin)に対して、次のコマンドでJavaシステムプロパティを設定します。
    otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名、または、IPアドレス>
    
  6. ユーザドメイン(domain1)に対しても、同じようにJavaシステムプロパティを設定します。
    otxadmin> login --user <管理ユーザ名> --password <管理ユーザパスワード> --port <管理ポート番号>
    
    (*) user の既定値は、admin、password の既定値は、adminadmin 、 port の既定値は、6212 です。
    otxadmin> create-jvm-options -Djava.rmi.server.hostname=<ホスト名、または、IPアドレス>
  7. WebOTXのサービスを再起動します。

  8. [ 4. 動作確認 ] で説明される方法にしたがって、動作確認を行って下さい。
Caution
ドメインを新たに作成する場合は、作成したドメインに対しても上記のJavaシステムプロパティを設定してください。

2.3.10. インストール後によく行う設定

2.4. 製品ライセンスの追加登録

2.4.1. WebOTX ASのライセンス体系

WebOTX ASは1ライセンスにつき2コアまで利用可能であり、インストール対象のマシンにマルチコアCPU及び複数のCPUが搭載されていてコア数の合計値が3以上の場合はライセンスの追加登録が必要です。
(2つ以上のプロセッサコアを1個のパッケージに集積したマイクロプロセッサをマルチコアと呼びます。)

製品ライセンスの追加登録は、OTXLAddコマンドを使用します。
Windowsの場合は[ 2.4.2. Windows ]、Linuxの場合は[ 2.4.3. HP-UX、Linux ]を参照してください。

WebOTX AS製品と必要なライセンス数の数え方の関係について説明します。

2.4.2. Windows

Built-in-Administratorユーザ、もしくは管理者権限のあるユーザでログインし、Windowsのサービス画面からWebOTX関連のサービスを全て停止した後、次の手順のとおりライセンスの登録作業を行ってください。

  1. ライセンス登録
    ライセンス登録は次のコマンドで行います。
    ※Built-in-Administratorユーザ以外の管理者権限のあるユーザでログインした場合、コマンドプロンプトは「管理者として実行」で起動してください
    >OTXLAdd
  2. ライセンスキーの入力
    "Please Input License Code" と表示されたら製品の「ライセンスキー」を入力します。
    製品の「ライセンスキー」は製品購入時に添付される「ソフトウェア使用認定証」の 「製品番号」に記載されている19桁の番号です。

    ライセンス登録作業が成功すれば、"Command Succeeded." と表示され OTXLAdd コマンドが終了します。

    複数の製品ライセンスを登録する場合は OTXLAddコマンドを複数回実行して各製品のライセンス登録を行ってください。
     
  3. ライセンス登録の確認
    ライセンスの登録情報一覧は次のコマンドで確認することができます。
    >OTXLChk

    ライセンス登録を行ったのにライセンス情報が表示されない場合は、 ライセンス登録作業が失敗している可能性があります。 次の点に注意しながら再度ライセンス登録を行ってください。


  4. 誤ってライセンス登録した場合は次の方法でライセンスを削除することができます。
    WebOTXのライセンス情報削除は、OTXLDelコマンドを使用します。

    Express の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

    >OTXLDel 2

    Standard の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

    >OTXLDel 3

    Enterprise の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

    >OTXLDel 4

    Administrator の場合

    >OTXLDel 6

2.4.3. HP-UX、Linux

rootユーザでログインし、WebOTX関連のサービスを全て停止した後、次の手順のとおりライセンスの登録作業を行ってください。

  1. ライセンス登録
    ライセンス登録は次のコマンドで行います。
    root> /opt/share.nec/bin/OTXLAdd
  2. ライセンスキーの入力
    "Please Input License Code" と表示されたら製品の「ライセンスキー」を入力します。
    製品の「ライセンスキー」は製品購入時に添付される「ソフトウェア使用認定証」の 「製品番号」に記載されている19桁の番号です。

    ライセンス登録作業が成功すれば、"Command Succeeded." と表示され OTXLAdd コマンドが終了します。

    複数の製品ライセンスを登録する場合は OTXLAddコマンドを複数回実行して各製品のライセンス登録を行ってください。
     
  3. ライセンス登録の確認
    ライセンスの登録情報一覧は次のコマンドで確認することができます。
    root> /opt/share.nec/bin/OTXLChk

    ライセンス登録を行ったのにライセンス情報が表示されない場合は、 ライセンス登録作業が失敗している可能性があります。 次の点に注意しながら再度ライセンス登録を行ってください。


  4. 誤ってライセンス登録した場合は次の方法でライセンスを削除することができます。
    WebOTXのライセンス情報削除は、OTXLDelコマンドを使用します。

    Express の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

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

    Standard の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

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

    Enterprise の場合 ※ライセンスを複数登録している場合は一つだけ削除されます。

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

    Administrator の場合

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