2. インストール

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

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

WebOTX製品のCD-ROM媒体は、対応するプラットフォームによって枚数や収録内容が異なります。

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

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

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

2.1.1. Windows
2.1.2. Linux
 
2.1.1. Windows

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

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

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

 
2.1.2. Linux

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

これらの作業が完了すれば「2.2. インストール作業」に進んでください。

 
2.2. インストール

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

2.2.1. Windows
2.2.2. Linux
 
2.2.1. Windows

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

有償製品
2.2.1.1. WebOTX Application Server Web Edition
2.2.1.2. WebOTX Application Server Standard-J Edition
2.2.1.3. WebOTX Administrator
2.2.1.4. WebOTX Application Server Standard-J Edition CU License
製品添付
2.2.1.5. オンラインマニュアル
2.2.1.6. WebOTX Client
2.2.1.7. EnterpriseDirectoryServer
 
2.2.1.1. WebOTX Application Server Web Edition のインストール
  1. WebOTXメディアのCD-ROM媒体を CD-ROMドライブに挿入すると、次の画面が表示されます。 [WebOTX Application Server Web Edition V8.1]を選び、「Install」ボタンを押してください。

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

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

    WebOTX メディアの開始画面

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

    Web Editionインストーラ開始画面

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

    ユーザ名入力画面

  4. [インストール済みの J2SE SDK] 画面が表示されますので、 既にマシンにインストールされている J2SE SDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、複数のJ2SE SDK がインストールされている場合、最後にインストールした J2SE SDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。

    インストール先指定画面

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

    インストール先指定画面

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

    カスタムセットアップ画面

    リストにある各アイコンの意味は次のとおりです。

    アイコン 説明
    Webサーバ WebOTX Webサーバをインストールします。 既定値ではインストールされません。 (*1)
    次の選択アイコンから[Webサーバ 2.0]か[Webサーバ 1.3]のどちらかを選択することができます。
      Webサーバ 2.0 Webサーバ(Apache HTTP Server 2.0.63 ベース)をインストールします。
    Webサーバ 1.3 Webサーバ(Apache HTTP Server 1.3.41 ベース)をインストールします。

    (*1)
    WebOTX内蔵型のJavaベースのWebサーバを使用する場合や、外部のWebサーバ、例えば、Microsoft Internet Information Server (IIS)などと連携動作させる場合には、インストーラから「WebOTXサーバ」選択する必要はありません。

  7. [ドメインの設定]画面が表示されますので、ドメインの動作モードおよびデフォルトのドメイン (domain1)で利用する HTTP/HTTPS 通信用のポート番号を設定後、「次へ」ボタンを押してください。
    ドメインの動作モードについて、WebOTX動作環境内に複数のドメインを作成できる構成にする場合は「マルチドメインモード」を、単一のドメインだけで構成する場合は「シングルドメインモード」を選択しててください。
    シングルドメインモードは、実行時の管理リソースが最小限となるため、ドメインの起動・停止が高速化される利点があります。 その反面、複数のドメイン環境を構築できない点において、拡張性が損なわれることに注意してください。
    また、ここで設定するポート番号は、他の製品で利用するポート番号と重複しないように設定してください。

    ドメイン設定画面

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

    インストール開始画面

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

    インストール中の画面

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

    ant_setup.bat 起動画面

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

    インストール終了画面

  12. コンピュータを再起動してください。

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

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

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

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

    WebOTX メディアの開始画面

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

    Standard-J Editionインストーラ開始画面


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

    ユーザ名登録画面


  4. [インストール済みの J2SE SDK] 画面が表示されますので、既にマシンにインストールされている J2SE SDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    また、複数のJ2SE SDK がインストールされている場合、最後にインストールした J2SE SDK のフォルダが表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。

    インストール先指定画面


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

    インストール先指定画面


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

    カスタムセットアップ画面

    リストにある各アイコンの意味は次のとおりです。

    アイコン 説明
    Webサーバ WebOTX Webサーバをインストールします。 既定値ではインストールされません。 (*1)
    次の選択アイコンから[Webサーバ 2.0]か[Webサーバ 1.3]のどちらかを選択することができます。
      Webサーバ 2.0 Webサーバ(Apache HTTP Server 2.0.63 ベース)をインストールします。
    Webサーバ 1.3 Webサーバ(Apache HTTP Server 1.3.41 ベース)をインストールします。

    (*1)
    WebOTX内蔵型のJavaベースのWebサーバを使用する場合や、外部のWebサーバ、例えば、Microsoft Internet Information Server (IIS)などと連携動作させる場合には、インストーラから「WebOTXサーバ」選択する必要はありません。

  7. [ドメインの設定]画面が表示されますので、ドメインの動作モードおよびデフォルトのドメイン (domain1)で利用する HTTP/HTTPS 通信用のポート番号を設定後、「次へ」ボタンを押してください。
    ドメインの動作モードについて、WebOTX動作環境内に複数のドメインを作成できる構成にする場合は「マルチドメインモード」を、単一のドメインだけで構成する場合は「シングルドメインモード」を選択しててください。 シングルドメインモードは、実行時の管理リソースが最小限となるため、ドメインの起動・停止が高速化される利点があります。 その反面、複数のドメイン環境を構築できない点において、拡張性が損なわれることに注意してください。
    また、ここで設定するポート番号は、他の製品で利用するポート番号と重複しないように設定してください。

    ポート設定画面


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

    インストール開始画面


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

    インストール中の画面


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

    ant_setup.bat 起動画面


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

    インストール終了画面


  12. コンピュータを再起動してください。

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

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

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

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

    WebOTX メディアの開始画面

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

    運用環境のインストーラ開始画面


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

    ユーザ名登録画面


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

    インストール先指定画面


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

    カスタムセットアップ画面

    リストにある各アイコンの意味は次のとおりです。

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

  6. [インストール済みの J2SE SDK] 画面が表示されますので、既にインストールされている J2SE SDK のフォルダを選択後、「次へ」ボタンを押してください。
    環境変数「JAVA_HOME」を設定している場合には、その設定値が表示されます。
    別のフォルダを選択する場合には「変更」ボタンを押してください。

    インストール先指定画面


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

    インストール開始画面


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

    インストール中の画面


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

    インストール終了画面


  10. コンピュータを再起動してください。

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

 
2.2.1.4. WebOTX Application Server Standard-J Edition CU License

CUライセンスは利用するマシンのCPU数にあわせて追加インストールします。

インストール対象のマシンがマルチコアCPUと呼ばれるプロセッサを搭載している場合の補足説明をします。

2つ以上のプロセッサコアを1個のパッケージに集積したマイクロプロセッサをマルチコアと呼びます。 WebOTX AS Standard-J Editionでは、マルチコアCPUの場合でも、1CPUとして計算します。 コア数とは関係なく、単にプロセッサ・パッケージの個数だけでライセンス数を計算することになります。

CPU数と追加CU数の対応については次のとおりです。

プロセッサ・パッケージ数   1     2    3〜 4  5〜 6  7〜 8  9〜16 17〜32 33〜64
追加するCUライセンス数 0 1 2 4 6 8 16 32

  1. WebOTX AS Standard-J Editionがインストールされていることを確認してください。
     
  2. Administrator権限でログインし、サービスマネージャで次のサービスを停止します。
    WebOTX AS Agent Service
  3. コマンドプロンプトから次のコマンドを実行します。 本コマンドにより、CUライセンスを1ライセンス分だけ追加します。 CUライセンスを複数追加する場合は、本コマンドを複数回実行します。
    > cd <install_dir>\share\bin
    > OTXLAdd
             (*) <install_dir>: Standard-J Editionをインストールしたディレクトリ
  4. 画面の指示に合わせて、ライセンスキーを入力します。
    ライセンスキーは製品購入時に添付される「ソフトウェア使用認定証」の「製品番号」に記載されている19桁の番号です。
     
  5. ライセンス追加処理が正常終了すると、「Command succeeded.」のメッセージが出力されます。
     
  6. ライセンスの登録情報一覧は次のコマンドで確認することができます。
    > OTXLChk

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

以上で WebOTX AS Standard-J Edition へのCUライセンス登録は完了です。

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

 
2.2.1.5. オンラインマニュアル

WebOTXオンラインマニュアルのインストールは、自己解凍形式のファイルをマシンにインストールし、 そのファイルを自動解凍するインストール形態となっています。

(注) オンラインマニュアルをインストールするには、ディスク容量として 約 500MB の空き容量が必要です。

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

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

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

    WebOTX メディアの開始画面

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

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

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

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

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

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

    WebOTX メディアの開始画面

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

    クライアントインストーラ開始画面


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

    ユーザ名登録画面


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

    インストール先指定画面


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

    カスタムセットアップ画面

    リストにある各アイコンの意味は次のとおりです。

    アイコン 説明
    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 クライアント実行環境 Transaction Service クライアント実行環境をインストールします。 クライアントでトランザクションを開始する場合に選択します。 この機能を利用する場合には、[JDBCデータソース]も選択してください。
    JDBCデータソース JDBCデータソースをインストールします。
    JMS JMS(クライアント)をインストールします。
    運用管理コマンド JMX (Java Management eXtensions) を利用した運用管理コマンドをインストールします。


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

    インストール開始画面


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

    インストール中の画面


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

    インストール終了画面


  9. コンピュータを再起動してください。

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

 
2.2.1.7. EnterpriseDirectoryServerのインストール

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

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

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

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

追加CUライセンスの登録は、ライセンス登録コマンドにより行います。 通常、ライセンス登録はWebOTXのインストールの前に行いますが、インストール後にシステム環境の変更や追加インストールする場合にもライセンス登録が必要となります。 ライセンス登録コマンドの使用方法については、「2.1. インストール前の作業」を参照してください。

 
2.2.2.1. インストールスクリプトを使用したインストール

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

手順は次のとおりです。

 
2.2.2.2. コマンドによる手動インストール

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

2.2.2.3. Linux
 
2.2.2.3 Linux

以下の説明では、RHEL 4.0での標準マウントポイント「/media/cdrom」にCD-ROMをマウントしたものとして説明しています。
rpm コマンドを使用してインストールします。 手順は次のとおりです。

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

    Linux(x86)の場合

    Linux(EM64T)の場合

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

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

   
2.2.2.4 Enterprise Directory Server

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

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

<マウントポイント>/SetupCard/EDS_SetupCard.pdf
 
2.3. インストール後の作業

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

2.3.1. Windows (WebOTX AS)
2.3.2. Windows (WebOTX Client)
2.3.3. Linux

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

2.3.4. データベースを使用するための準備作業 (Java)
2.3.5. データベースを使用するための準備作業 (C++)
 
2.3.1. Windows (WebOTX AS)

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

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

これらの作業が完了すれば「2.3.4. データベースを使用するための準備作業 (Java)」に進んでください。

 
2.3.2. Windows (WebOTX Client)

Windows版のWebOTX Clientをインストールした後に行う作業について説明します。

 
2.3.3. Linux

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

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

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


これらの作業が完了すれば「2.3.4. データベースを使用するための準備作業 (Java)」に進んでください。

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

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

Oracle での作業 Sybase Adaptive Server Enterprise での作業 Microsoft SQL Server での作業

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

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

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

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

Oracle での作業 Microsoft SQL Server での作業 IBM WebSphere MQ での作業  
2.3.6. LinuxにおいてRMI通信でリモート接続を利用するための設定

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

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

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

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

上記の条件に当てはまる場合、リモート接続を可能とするために、 /etc/hostsファイルから「ホスト名」を削除して、127.0.0.1 に対応するのは localhost のみとしてください。


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

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

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

    # /etc/init.d/WOAgentSvc start

  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のサービスを再起動します。

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

  8. 「5. 動作確認」で説明される方法にしたがって、動作確認を行って下さい。

　注）ドメインを新たに作成する場合は、作成したドメインに対しても上記のJavaシステムプロパティを設定してください。

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

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. [ 5. 動作確認 ] で説明される方法にしたがって、動作確認を行って下さい。

　注）ドメインを新たに作成する場合は、作成したドメインに対しても上記のJavaシステムプロパティを設定してください。