Webコンテナの動作モードがマルチプロセスモードの場合

1. WebOTX統合運用管理ツールを起動し、左ツリーのdomain配下の"TPシステム"上に"J2EE"モジュールとして、アプリケーショングループ"OTXJSP"およびプロセスグループ"OTXJSP"を作成します。

2. 左ツリーの"アプリケーション"を右クリックし、"コンポーネント配備ウィザード"を起動します。

3. 「コンポーネント配備ウィザード」にて以下のとおり設定します。




「コンポーネント配備ウィザード」 (１ページ目)

アップロード	V　(チェック状態：ローカルPCよりアップする場合)
コンポーネントタイプ	Webコンポーネント
ファイル	C:\WebOTX\JSP\Runtime\OTXJSP.war　(デフォルトの場合)





「コンポーネント配備ウィザード」 (２ページ目)

コンポーネント名	OTXJSP
アプリケーショングループ	OTXJSP
プロセスグループ	OTXJSP




「コンポーネント配備ウィザード」 (３ページ目)

仮想サーバ	serverにV　(チェック状態)
アプリケーショングループ	/OTXJSP




4. 「配備」ボタンを押下してください。

Webコンテナの動作モードがシングルプロセス(旧互換動作モード)の場合

1. WebサーバとWebOTX Webコンテナ(ドメイン)が起動していない場合は、起動してください。

2. WebOTX Webコンテナの運用管理コンソールをWebブラウザから起動してください。起動方法は「Webコンテナの運用管理コンソール起動方法」を参照してください。

3. 運用管理コンソールの左部にて「Web Application管理」をクリックし、右部の「配備」-「WARファイルの配備アップロード 」もしくは「サーバ上に配置されたディレクトリまたはWARファイルの配備」にて以下のとおり設定します。




「WARファイルの配備アップロード」 (WebAP JSPがローカルマシン上にある場合に利用)

アップロードする WARファイルの選択	C:\WebOTX\JSP\Runtime\OTXJSP.war　(デフォルトの場合)
Application Name	OTXJSP
Context Root	/OTXJSP
Virtual Server	server (左記はデフォルトの場合　 仮想サーバー名を指定してください。)





「サーバ上に配置されたディレクトリまたはWARファイルの配備」 (WebAP JSPがサーバ上にある場合に利用)

WARまたはディレクトリのURL:	file:///opt/WebOTXJSP/Runtime/OTXJSP.war　(デフォルトの場合)
Application Name	OTXJSP
Context Root	/OTXJSP
Virtual Server	server (デフォルトの場合　 仮想サーバー名を指定してください。)




4. 「配備」ボタンを押下してください。

HP-UX/Linux上でWebAP JSP が動作可能なWebサーバとServletコンテナの組み合わせのパターンは以下のとおりです。
以下では、それぞれのパターンについて、設定方法を説明します。
環境設定は、WebAP JSPが提供する環境設定ツールで行うことを推奨します。

＜HP-UX 32bit版＞

• iPlanet Web Server4.1とJRun4.0を使用する場合
• iPlanet Web Server4.1を使用する場合
• Sun ONE Web Server6.0(iPlanet Web Server6.0)とJRun4.0を使用する場合
• Sun ONE Web Server6.0とWebOTX Webコンテナv5.0を使用する場合
• Sun ONE Web Server6.0を使用する場合
• Apache1.3とJRun4.0を使用する場合
• Apache1.3とWebOTX Webコンテナv5.0を使用する場合
• Apache2.0とJRun4.0を使用する場合
• WebOTX Webサーバ1.3/2.0とJRun4.0を使用する場合
• WebOTX Webサーバ1.3/2.0とWebOTX Webコンテナv5.0を使用する場合

＜HP-UX IPF版＞

• WebOTX Webサーバ1.3/2.0とWebOTX Webコンテナv5.0を使用する場合

＜Linux版＞

• WebOTX Webサーバ1.3/2.0とWebコンテナv5.0

以下の手順で設定を行ってください。
WebサーバおよびServletコンテナの設定についての詳細は、それぞれのマニュアルを参照してください。

1. iPlanet Web ServerとJRun4.0をインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. iPlanet Web ServerとJRunを停止してください。

4. 雛形web.xmlファイルを修正して、「セキュリティ設定」を行ってください。セキュリティの設定以外でも、web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。

5. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とJRun4.0の設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarへのパスをクラスパスに追加してください。設定内容はJRun4.0の設定の「クラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、iPlanet Web ServerとJRunサーバを起動してください。
   JRunの起動方法は、「JRunの起動方法」を参照してください。

8. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

1. JRunとWebサーバの接続の設定

   1. 接続先のJRunサーバを起動します。

   2. JRunのマニュアルを参照して「Webサーバー設定ツール」を実行してください。

iPlanet Web ServerをWebサーバおよびServletコンテナとして使用する場合は、以下の手順で設定を行ってください。
iPlanet Web Serverの設定についての詳細は、iPlanet Web Serverのマニュアルを参照してください。特にOSのパラメータ設定が適切に行われていない場合、正常に動作しない場合がありますので注意してください。

1. iPlanet Web Serverをインストールしてください。

2. 以下の場所にある、WebAP JSPの「環境設定ツール」（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とiPlanet Web Server（内蔵コンテナ）の設定の作業をを行ってください。

3. 環境設定ツールを使用した場合も、使用しなかった場合も「環境設定ツール実行後の作業」を行ってください。

4. 設定が終了したら、iPlanet Web Serverを再起動してください。

5. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

6. 「セキュリティ設定」を参照して、セキュリティの設定を行ってください。

■iPlanet Web Serverの設定

iPlanet Web Serverの管理用ホームページにWebブラウザからアクセスし、以下の設定を行ってください。管理用ホームページの表示方法については、iPlanet Web Serverのマニュアルを参照してください。
Internet Explorerを使用した場合、設定内容が正しく表示されない場合があります。Netscape Navigatorを使われることを推奨します。

1. Webサーバを停止します。

   iPlanetの管理サーバをWebブラウザからアクセスしてください。
   これから設定するWebサーバが起動している場合には、停止してください。

2. コンフィグレーションを変更します。

   1. Webサーバディレクトリ配下のconfig/contexts.propertiesに以下を追加します。すでに追加されている場合には、その行を修正します。

      • UNICODE変換をiPlanetの機能により行う場合
        

        context.global.parameterEncoding=auto context.global.sessionExpireOnClose=true

        
        

      • UNICODE変換をWebAP JSPの機能により行う場合
        

        context.global.parameterEncoding=none context.global.sessionExpireOnClose=true

        
        

      context.global.parameterEncodingの値は、WebAP JSPがブラウザから 取得するマルチバイト文字列のUNICODE変換に影響します。iPlanetのSP番号によっても設定が異なります。詳細は、「ServletコンテナとしてiPlanetを使用する場合のマルチバイトのUNICODE変換について」を参照してください。

      空白などが入らないように注意してください。
      先頭に「#」がある行はコメント行です。コメント行は変更しないでください。
      以降の処理で コンフィグレーションが更新されていることを示すメッセージが表示される場合があります。これは、ここでconfigの内容を更新したためです。その場合、表示される「Load Configuration Files」ボタンを押してロードしてください。

   2. 「Global Setting」の「Configrure JRE/JDK Paths」の「JDK」の「JDK Path: 」にJDK 1.3以上がインストールされているパスを設定します。
      例：/opt/java1.3

   3. 管理サーバのWeb画面で使用するWebサーバを選択し、Webサーバの設定画面を表示します。

   4. 「Servlets」タブを選択します。

   5. 「Enable/Disable Servlets/JSP」の「Enable JSP?」の項目を「Yes」に設定します。

   6. 「Configure Servlet Attributes」を使用し以下のサーブレット項目を設定します。それぞれの項目を設定後「OK」ボタンを押してください。
      その後に表示される画面では、「Save」を選択してください。
      以降も同様に「OK」、「Save」を押してください。
      ここでは、WebAP JSPを[/opt/WebOTXJSP]にインストールしたものとします。別の場所にインストールした場合にはインストールディレクトリ配下を示すように適宜修正してください。

      Servlet Name:	RUN
      Servlet Code (class name):	jp.co.nec.webapjsp.run.ServletRun
      Servlet Classpath:	/opt/WebOTXJSP/Runtime/lib/otxjsp.jar
      Servlet Args:	INSTDIR=/opt/WebOTXJSP/Runtime

      ファイル転送にファイル転送サーバを使用しない場合は、以下の二つのサーブレット項目も設定します。

      Servlet Name:	RW
      Servlet Code (class name):	jp.co.nec.webapjsp.run.filetran.FileWrite
      Servlet Classpath:	/opt/WebOTXJSP/Runtime/lib/otxjsp.jar
      Servlet Args:	INSTDIR=/opt/WebOTXJSP/Runtime

      Servlet Name:	ADMIN
      Servlet Code (class name):	jp.co.nec.webapjsp.run.RunManage
      Servlet Classpath:	/opt/WebOTXJSP/Runtime/lib/otxjsp.jar
      Servlet Args:	INSTDIR=/opt/WebOTXJSP/Runtime

   7. 「Configure Servlet Virtual Path Translation」を使用し以下のサーブレットバーチャルパスを設定します。それぞれの項目は設定後「OK」ボタンを押してください。
      その後に表示される画面では、「Save」を選択してください。

      Virtual Path:	/OTXJSP/RUN
      Servlet Name:	RUN

      ファイル転送にファイル転送サーバを使用しない場合は、以下の二つのサーブレットバーチャルパスも設定します。

      Virtual Path:	/OTXJSP/RW
      Servlet Name:	RW

      Virtual Path:	/OTXJSP/ADMIN
      Servlet Name:	ADMIN

   8. 「Configure JVM Attributes」を使用しJavaVMのオプションとクラスパスに以下を追加します。
      この中にはObject Brokerが使用する各jarファイルおよびJDKのjarファイルを含みます。

      • JDK 1.3を使用する場合

        • Object Brokerバージョン6.x以上を使用する場合
          以下の例は、WebAP JSPインストールディレクトリが「/opt/WebOTXJSP/Runtime」、Object Brokerのインストールディレクトリが「/opt/ObjectSpinner」、JDK 1.3のインストールディレクトリが「/opt/java1.3」、WebOTX ASのインストールディレクトリが「/opt/WebOTX」の場合です。

          Option:	-Xbootclasspath:"/opt/ObjectSpinner/lib/jsocks.jar:/opt/ObjectSpinner/lib/ospievnt50.jar:/opt/ObjectSpinner/lib/ospiname50.jar:/opt/ObjectSpinner/lib/ospiorb50.jar:/opt/java1.3/jre/lib/rt.jar:/opt/java1.3/jre/lib/i18n.jar:/opt/java1.3/lib/tools.jar:"
          Classpath:	:/opt/WebOTXJSP/Runtime/lib/otxjsp.jar

          MFDL移行のWebアプリケーションを実行する場合は、上記に加えてClasspathに以下のパスを追加してください。
          

          :/opt/WebOTXJSP/Runtime/lib/mfdl50.jar

          WebOTXのWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合は、上記に加えてWOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jarへのパスを追加してください。WOTXBS90.jarはWebOTX Developer(for CORBA Application)、またはWebOTX ASに含まれています。WebOTX ASに含まれているWOTXBS90.jarを指定する場合、以下のパスを追加してください。
          

          :/opt/WebOTX/Trnsv/lib/WOTXBS90.jar

        • ObjectSpinnerバージョン5.xを使用する場合
          以下の例は、WebAP JSPインストールディレクトリが「/opt/WebOTXJSP/Runtime」、ObjectSpinnerのインストールディレクトリが「/opt/ObjectSpinner」、JDK 1.3のインストールディレクトリが「/opt/java1.3」、WebOTX ASのインストールディレクトリが「/opt/WebOTX」の場合です。

          Option:	-Xbootclasspath:"/opt/ObjectSpinner/lib/jsocks.jar:/opt/ObjectSpinner/lib/ospievnt50.jar:/opt/ObjectSpinner/lib/ospiname50.jar:/opt/ObjectSpinner/lib/ospiorb50.jar:/opt/java1.3/jre/lib/rt.jar:/opt/java1.3/jre/lib/i18n.jar:/opt/java1.3/lib/tools.jar:"
          Classpath:	:/opt/WebOTXJSP/Runtime/lib/otxjsp.jar

          MFDL移行のWebアプリケーションを実行する場合は、上記に加えてClasspathに以下のパスを追加してください。
          

          :/opt/WebOTXJSP/Runtime/lib/mfdl50.jar

          WebOTXのWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合は、上記に加えてWOTXBS50.jarへのパスを追加してください。WOTXBS50.jarはWebOTX Developer(for CORBA Application)、またはWebOTX ASに含まれています。WebOTX ASに含まれているWOTXBS50.jarを指定する場合、以下のパスを追加してください。
          

          :/opt/WebOTX/Trnsv/lib/WOTXBS50.jar

        • ObjectSpinner バージョン4.x またはObjectSpinner互換ライブラリを使用する場合
          以下の例は、WebAP JSPインストールディレクトリが「/opt/WebOTXJSP/Runtime」、ObjectSpinnerのインストールディレクトリが「/opt/ObjectSpinner」、JDK 1.3のインストールディレクトリが「/opt/java1.3」の場合です。

          Option:	-Xbootclasspath:"/opt/ObjectSpinner/lib/jsocks.jar:/opt/ObjectSpinner/lib/ospievnt.jar:/opt/ObjectSpinner/lib/ospiname.jar:/opt/ObjectSpinner/lib/ospiorb.jar:/opt/java1.3/jre/lib/rt.jar:/opt/java1.3/jre/lib/i18n.jar:/opt/java1.3/lib/tools.jar:"
          Classpath:	:/opt/WebOTXJSP/Runtime/lib/otxjsp.jar

          MFDL移行のWebアプリケーションを実行する場合は、上記に加えてClasspathに以下のパスを追加してください。
          

          :/opt/WebOTXJSP/Runtime/lib/mfdl.jar

   9. 「Content Mgmt」タブを選択します。

   10. 「Cache Control Directives」を選んでください。
       つぎに、Editingのところにrunerr.jsp、disable.jspが保管されているディレクトリを指定してください。
       「C:/Netscape/Server4/docs/jsp/*」のような設定になります。
       つぎに「Cache Control Response Directives」項目で「No Cache」を選択し、「OK」を実行してください。
       これによりエラー表示用JSPファイル、受け付け停止時のリダイレクト用JSPファイルがキャッシュされることを防ぎます。

3. サーブレット名「RUN」をPRELOAD（Startup Servlets）に設定してください。
   これは、iPlanet4.1の場合、サーブレットがメモリ中に読み込まれていない状態で複数のWebブラウザから同時にサーブレットが実行されると初期化処理が複数回実行されてしまう問題があるためです。RUNをStartup Servletsに設定することにより、複数回実行されることを抑制できます。
   PRELOADの設定手順は以下のとおりです。

   • 「Servlets」タブの「Configure Global Servlet Attributes」を選択します。
   • 「Startup Servlets:」に「RUN」を設定します。
   • 「OK」ボタンをクリックし、設定を反映します。

4. Webサーバを再起動します。

   1. 管理サーバのWeb画面からWebサーバを起動してください。正常に起動できなかった場合には、これまでの設定を見直してください。特に以下の設定を確認してください。

      • JDKの場所
      • クラスパスの設定

以下の手順で設定を行ってください。
WebサーバおよびServletコンテナの設定についての詳細は、それぞれのマニュアルを参照してください。

1. Sun ONE Web ServerとJRun4.0をインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. Sun ONE Web ServerとJRunを停止してください。

4. 雛形web.xmlファイルを修正して、「セキュリティ設定」を行ってください。セキュリティの設定以外でも、web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。

5. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とJRun4.0の設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarへのパスをクラスパスに追加してください。設定内容はJRun4.0の設定の「クラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、Sun ONE Web ServerとJRunサーバを起動してください。
   JRunの起動方法は、「JRunの起動方法」を参照してください。

8. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

1. JRunとWebサーバの接続の設定

   1. 接続先のJRunサーバを起動します。

   2. JRunのマニュアルを参照して「Webサーバー設定ツール」を実行してください。

以下の手順で設定を行ってください。
WebサーバおよびServletコンテナの設定についての詳細は、それぞれのマニュアルを参照してください。特にOSのパラメータ設定が適切に行われていない場合、正常に動作しない場合がありますので注意してください。

1. Sun ONE Web ServerとWebOTX Webコンテナをインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. Sun ONE Web ServerとWebOTX Webコンテナ(ドメイン)を停止してください。

4. web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。「セキュリティ設定」はあらかじめ雛形web.xmlファイルに記述されています。

5. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とWebコンテナの設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jarへのパスをクラスパスに追加してください。クラスパスの設定は、Webコンテナの設定の「Webコンテナ起動用ファイル中のクラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、Sun ONE Web ServerとWebOTX Webコンテナ(ドメイン)を起動してください。

8. 「OTXJSP.warの配備」を参照して、OTXJSP.warを配備してください。

9. Sun ONE Web ServerとWebOTX Webコンテナ(ドメイン)を再起動してください。

10. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

11. セキュリティの設定を変更したい場合は「セキュリティ設定」を参照してください。
    運用管理画面（admin.jsp）と業務閉塞用JSPファイル（transcntl.jsp）のアクセス制限はすでに設定されています。運用管理画面にアクセスする場合、業務閉塞用コマンドを実行する場合は、Webコンテナにデフォルトで設定されているユーザ名「admin」、パスワード「adminadmin」を入力してください。ユーザ名やパスワードを変更したい場合は、「Webコンテナのユーザ名とパスワードの変更」を参照してください。

1. WebOTX Webコンテナの環境設定

   WebOTX Webコンテナをインストール後にWebOTX Webコンテナの環境設定ツールを起動し、環境設定を行ってください。WebOTX Webコンテナを起動するためには、環境設定が必要です。
   WebOTX Webコンテナの環境設定の詳細については、WebOTXの「 セットアップガイド」の「インストール後の作業」の「HP-UX、Linux」を参照してください。

Sun ONE Web ServerをWebサーバおよびServletコンテナとして使用する場合は、以下の手順で設定を行ってください。
Sun ONE Web Serverの設定についての詳細は、Sun ONE Web Serverのマニュアルを参照してください。

1. Sun ONE Web Serverをインストールしてください。

2. web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。

3. Sun ONE Web Serverを起動してください。

4. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とSun ONE Web Server（内蔵コンテナ）の設定の作業を行ってください。

5. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarへのパスをクラスパスに追加してください。設定内容はSun ONE Web Server（内蔵コンテナ）の設定の「クラスパスの設定」に従ってください。
     
     

6. 環境設定ツールを使用した場合も、使用しなかった場合も「環境設定ツール実行後の作業」を行ってください。

7. 設定が終了したら、Sun ONE Web Serverを起動してください。

8. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

9. 「セキュリティ設定」を参照して、セキュリティの設定を行ってください。

1. ApacheとJRun4.0をインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. ApacheとJRunを停止してください。

4. 雛形web.xmlファイルを修正して、「セキュリティ設定」を行ってください。セキュリティの設定以外でも、web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。

5. 以下の場所にある、WebAP JSPの「環境設定ツール」（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とJRun4.0の設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarへのパスをクラスパスに追加してください。設定内容はJRun4.0の設定の作業の「クラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、ApacheとJRunサーバを起動してください。
   JRunの起動方法は、「JRunの起動方法」を参照してください。

8. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

■Apacheの設定

1. Webサーバの新規インスタンスを作成する場合、JRunのコネクタウィザードが認識できるように、HTTP Server コンフィグレーションファイルの名前は必ずhttpd.confにしてください。
   複数のWebサーバを作成する場合は、Webサーバごとにディレクトリを分けて、httpd.confを格納してください。

■JRunの設定

1. JRunとWebサーバの接続の設定

   1. 接続先のJRunサーバを起動します。

   2. JRunのマニュアルを参照して「Webサーバー設定ツール」を実行してください。

以下の手順で設定を行ってください。
WebサーバおよびServletコンテナの設定についての詳細は、それぞれのマニュアルを参照してください。特にOSのパラメータ設定が適切に行われていない場合、正常に動作しない場合がありますので注意してください。

1. ApacheとWebOTX Webコンテナをインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. ApacheとWebOTX Webコンテナ(ドメイン)を停止してください。

4. web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。「セキュリティ設定」はあらかじめ雛形web.xmlファイルに記述されています。

5. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とWebコンテナの設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jarへのパスをクラスパスに追加してください。クラスパスの設定は、Webコンテナの設定の「Webコンテナ起動用ファイル中のクラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、ApacheとWebOTX Webコンテナ(ドメイン)を起動してください。

8. 「OTXJSP.warの配備」を参照して、OTXJSP.warを配備してください。

9. ApacheとWebOTX Webコンテナ(ドメイン)を再起動してください。

10. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

11. セキュリティの設定を変更したい場合は「セキュリティ設定」を参照してください。
    運用管理画面（admin.jsp）と業務閉塞用JSPファイル（transcntl.jsp）のアクセス制限はすでに設定されています。運用管理画面にアクセスする場合、業務閉塞用コマンドを実行する場合は、Webコンテナにデフォルトで設定されているユーザ名「admin」、パスワード「adminadmin」を入力してください。ユーザ名やパスワードを変更したい場合は、「Webコンテナのユーザ名とパスワードの変更」を参照してください。

1. WebOTX Webコンテナの環境設定

   WebOTX Webコンテナをインストール後にWebOTX Webコンテナの環境設定ツールを起動し、環境設定を行ってください。WebOTX Webコンテナを起動するためには、環境設定が必要です。
   WebOTX Webコンテナの環境設定の詳細については、WebOTXの「 セットアップガイド」の「インストール後の作業」の「HP-UX、Linux」を参照してください。

1. WebOTX WebサーバとJRun4.0をインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. WebOTX WebサーバとJRunを停止してください。

4. 雛形web.xmlファイルを修正して、「セキュリティ設定」を行ってください。セキュリティの設定以外でも、web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。

5. 以下の場所にある、WebAP JSPの「環境設定ツール」（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とJRun4.0の設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jarへのパスをクラスパスに追加してください。設定内容はJRun4.0の設定の作業の「クラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、WebOTX WebサーバとJRunサーバを起動してください。
   JRunの起動方法は、「JRunの起動方法」を参照してください。

8. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

1. JRunとWebサーバの接続の設定

   1. 接続先のJRunサーバを起動します。

   2. JRunのマニュアルを参照して「Webサーバー設定ツール」を実行してください。

以下の手順で設定を行ってください。
WebサーバおよびServletコンテナの設定についての詳細は、それぞれのマニュアルを参照してください。特にOSのパラメータ設定が適切に行われていない場合、正常に動作しない場合がありますので注意してください。

1. WebOTX WebサーバとWebOTX Webコンテナをインストールしてください。

2. 「環境設定ツール実行前の作業」を行ってください。

3. WebOTX WebサーバとWebOTX Webコンテナ(ドメイン)を停止してください。

4. web.xmlファイルの設定を変更したい場合は、雛形web.xmlファイルを修正してください。「セキュリティ設定」はあらかじめ雛形web.xmlファイルに記述されています。

5. 以下の場所にある、WebAP JSPの環境設定ツール（setconf.sh）を実行してください。
   
   /opt/WebOTXJSP/Runtime/setconf.sh
   
   環境設定ツールは「環境設定ツールを使用しない場合の作業」に記述している設定を自動で行います。
   環境設定ツールを使用しない場合は、「環境設定ツールを使用しない場合の作業」のWebサーバの設定とWebコンテナの設定の作業を行ってください。

6. 次の場合は、環境設定ツールを実行した後にクラスパスの修正を行う必要があります。

   • WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合
     WOTXBS90.jarへのパスをクラスパスに追加してください。クラスパスの設定は、Webコンテナの設定の「Webコンテナ起動用ファイル中のクラスパスの設定」に従ってください。
     
     

7. 設定が終了したら、WebOTX WebサーバとWebOTX Webコンテナ(ドメイン)を起動してください。

8. 「OTXJSP.warの配備」を参照して、OTXJSP.warを配備してください。

9. WebOTX WebサーバとWebOTX Webコンテナ(ドメイン)を再起動してください。

10. 環境設定が正しく行われていることを確認してください。確認方法は「動作確認」を参照してください。

11. セキュリティの設定を変更したい場合は「セキュリティ設定」を参照してください。
    運用管理画面（admin.jsp）と業務閉塞用JSPファイル（transcntl.jsp）のアクセス制限はすでに設定されています。運用管理画面にアクセスする場合、業務閉塞用コマンドを実行する場合は、Webコンテナにデフォルトで設定されているユーザ名「admin」、パスワード「adminadmin」を入力してください。ユーザ名やパスワードを変更したい場合は、「Webコンテナのユーザ名とパスワードの変更」を参照してください。

1. WebOTX Webコンテナの環境設定

   WebOTX Webコンテナをインストール後にWebOTX Webコンテナの環境設定ツールを起動し、環境設定を行ってください。WebOTX Webコンテナを起動するためには、環境設定が必要です。
   WebOTX Webコンテナの環境設定の詳細については、WebOTXの「 セットアップガイド」の「インストール後の作業」の「HP-UX、Linux」を参照してください。

WebAP JSPがObject Broker バージョン6.x以上またはObjectSpinner バージョン5.xを使用する場合で、 WebOTX のWO_Baseから派生したインタフェースを定義しているサーバAPにアクセスする場合は、 WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar（ObjectSpinner バージョン5.xの場合はWOTXBS50.jar）が必要です。
WOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarは、インストールしたWebOTX ASまたはWebOTX Developer(for CORBA Application)の以下の場所にあります。

• WebOTX バージョン7.xとObject Broker バージョン9.xを使用する場合
  • WebOTX ASをインストールしている場合
    /opt/WebOTX/Trnsv/lib/WOTXBS90.jar
    
    
  • WebOTX Developer(for CORBA Application)をインストールしている場合
    /opt/WebOTX/dev/javalib/WOTXBS90.jar
    
    
• WebOTX バージョン6.xとObject Broker バージョン8.xを使用する場合
  • WebOTX ASをインストールしている場合
    /opt/WebOTX/Trnsv/lib/WOTXBS80.jar
    
    
  • WebOTX Developer(for CORBA Application)をインストールしている場合
    /opt/WebOTX/dev/javalib/WOTXBS80.jar
    
    
• WebOTX バージョン5.xとObject Broker バージョン7.xを使用する場合
  • WebOTX ASをインストールしている場合
    /opt/WebOTX/Trnsv/lib/WOTXBS70.jar
    
    
  • WebOTX Developer(for CORBA Application)をインストールしている場合
    /opt/WebOTX/dev/javalib/WOTXBS70.jar
    
    
• WebOTX バージョン4.2とObject Broker バージョン6.xを使用する場合
  • WebOTX ASをインストールしている場合
    /opt/WebOTX/Trnsv/lib/WOTXBS60.jar
    
    
  • WebOTX Developer(for CORBA Application)をインストールしている場合
    /opt/WebOTX/dev/javalib/WOTXBS60.jar
    
    
• WebOTX バージョン3.2とObjectSpinner バージョン5.xを使用する場合
  • WebOTX ASをインストールしている場合
    /opt/WebOTX/Trnsv/lib/WOTXBS50.jar
    
    
  • WebOTX Developer(for CORBA Application)をインストールしている場合
    /opt/WebOTX/dev/javalib/WOTXBS50.jar
    
    

WebOTX ASもWebOTX Developer(for CORBA Application)もインストールしていないマシン上でWebAP JSPを動作させる場合は、WebAP JSPをインストールしているマシンにWOTXBS90.jar/WOTXBS80.jar/WOTXBS70.jar/WOTXBS60.jar/WOTXBS50.jarをコピーしてください。
WebOTX ASに含まれるファイルとWebOTX Developer(for CORBA Application)に含まれるファイルのどちらを使用しても問題ありません。

JRunのインストールディレクトリ/binに移動後、以下のコマンドを入力してください。再起動時は、一度終了してから、再度起動してください。詳細については、JRunのマニュアルを参照してください。

起動： >./jrun -start default
終了： >./jrun -stop default

1. JRunの動作確認

   • JRun4.0の場合

     JRunのwelcomeページが表示できるか確認します。
     Webブラウザから、以下のURLにアクセスしてください。

     http://Webサーバ名(ドメイン省略不可):ポート番号/index.jsp

     次の画面が表示されればOKです。

     

2. WebAP JSPの動作確認
   WebAP JSPのタイトルページが正しく表示されるかどうかを確認します。Webブラウザから、以下のURLにアクセスしてください。

   http://Webサーバ名(ドメイン省略不可):ポート番号/OTXJSP/RUN

   「WebOTX WebAP JSP」と表示されればOKです。

WebAP JSPは、WebサーバとServletコンテナ上でWebアプリケーションを動作させるために必要な設定を行う「環境設定ツール」を提供しています。

Windows版では、WebAP JSPのインストールの途中で環境設定ツールを使用して環境設定を行うことができます。インストール中に環境設定を行わなかった場合、または一度設定した環境設定を変更する場合は、スタートメニューから環境設定ツールを起動して設定を行うことができます。

■準備

環境設定ツールで設定を行う前には、以下の準備が必要です。

1. 使用するJDK、Webサーバ、Servletコンテナ、Object Brokerをインストールしてください。

2. WebサーバとServletコンテナが連携して動作できるように設定を行ってください。設定方法については、「WebサーバとServletコンテナの環境設定 - Windows版」の各Web環境ごとの「環境設定ツール実行前の作業」を参照してください。

■使用手順

1. Administratorsローカルグループに所属するユーザーでログオンしてください。

2. Webサーバ、Servletコンテナを停止してください。
   ServletコンテナとしてSun ONE Web Serverの内蔵コンテナを使用する場合は、起動したままで結構です。

3. スタートメニューの［WebOTX］−［WebAP JSP］−［環境設定］を選択してください。
   次の画面が表示されます。
   64bit版の場合は、選択可能なWebサーバ、Servletコンテナの組み合わせが異なります。
   サポートしているWebサーバ、Servletコンテナの組み合わせについては「動作基本ソフトウェア(OS)」を参照してください。

   

4. 「OK」ボタンをクリックして設定を完了すると、Webサーバ、およびServletコンテナに設定情報を反映します。「キャンセル」ボタンをクリックすると反映せずにツールを終了します。

   Sun ONE Web ServerをServletコンテナとして使用する場合は、「OK」ボタンをクリック後に、仮想サーバIDを入力するダイアログが表示されます。仮想サーバIDを入力してください。デフォルトは「https-(Webサーバ名)」です。

5. iPlanet Web ServerをServletコンテナとして使用する場合は、「環境設定ツール」実行後に、クラスパスなどの設定をiPlanet Web Serverの管理用ホームページから行う必要があります。
   JavaVMのオプション、クラスパスの情報が以下のファイルに出力されますので、設定時に参照してください。

   WebAP JSPのインストールディレクトリ\tmp\javaclass.txt

環境設定ツール使用時の注意事項については、「注意制限事項」の「実行環境」の「環境設定ツール」を参照してください。

環境設定に失敗した場合は、エラー情報が「WebAP JSPインストールディレクトリ\logs\setconf.log」ファイルに出力されますので、参照してください。

■「環境設定ツール」画面の項目

画面の各項目について説明します。

HP-UX版/Linux版では、WebAP JSPをインストール後に環境設定ツールを起動して環境設定を行います。

注意：HP-UX版/Linux版の環境設定ツールは、OSやWebサーバなどのバージョン確認を行っておりません。そのため、実際にはサポート対象外の組み合わせでも環境設定が可能な場合があります。あらかじめWebOTX WebAP JSPセットアップガイド「動作基本ソフトウェア(OS)」をご覧になり、サポート対象内の組み合わせにて環境設定を行ってください。

■準備

環境設定ツールで設定を行う前には、以下の準備が必要です。

1. 使用するJDK、Webサーバ、Servletコンテナ、Object Brokerをインストールしてください。

2. WebサーバとServletコンテナが連携して動作できるように設定を行ってください。設定方法については、「WebサーバとServletコンテナの環境設定 - HP-UX版/Linux版」の各Web環境ごとの「環境設定ツール実行前の作業」を参照してください。

■使用手順

1. Webサーバ、Webコンテナ(ドメイン)を停止してください。
   ServletコンテナとしてSun ONE Web Serverの内蔵コンテナを使用する場合は、起動したままで結構です。

2. ログイン名 root でログインしてください。

   login: root
   

3. WebAP JSPのインストールディレクトリへ移動します。

   root> cd /opt/WebOTXJSP/Runtime
   

4. sh ./setconf.shと入力し環境設定ツールを起動してください。

   root> sh ./setconf.sh
   

5. スクリプトの指示にしたがって、必要な情報を設定してください。
   HP-UX(IPF)版の場合は、選択可能なWebサーバ、Servletコンテナ、JDKの組み合わせが異なります。サポートしているWebサーバ、Servletコンテナ、JDKの組み合わせについては「動作基本ソフトウェア(OS)」を参照してください

   1. WebAP JSPのインストールディレクトリの設定（デフォルト以外の場合のみ）

      Please enter WebOTX WebAP JSP installation directory:

      WebAP JSPがデフォルト以外の場所にインストールされている場合、上記のメッセージが表示されます。インストールディレクトリへのパスを入力してください。
      デフォルトの場所（/opt/WebOTXJSP）にインストールされている場合は、上記のメッセージは表示されません。

   2. Webサーバの種類の設定

      • HP-UX版の場合

        Please choose WebServer (A)pache,(i)Planet4.1,(S)un ONE6.0,(W)ebOTX Web Server :

      • Linux版の場合

        Please choose WebServer (A)pache,(S)un ONE6.0,(W)ebOTX Web Server :

      使用するWebサーバの種類を選択肢から選んで、()の中の文字を入力してください。「Sun ONE」は「Sun ONE Web Server 6.0」のことを指します。

   3. Webサーバのドキュメントルートディレクトリの設定

      • WebOTX Webサーバの場合

        Please input WebServer Document Directory [/opt/WebOTX/domains/domain1/docroot] :

      • WebOTX Webサーバ以外の場合

        Please input WebServer Document Directory [] :

      Webサーバのドキュメントルートディレクトリへのパスを入力してください。
      WebOTX Webサーバの場合の既定値：/opt/WebOTX/domains/domain1/docroot

   4. Servletコンテナの種類の設定

      • Apacheの場合

        Please choose ServletContainer
        (J)Run4,(W)ebOTX Web Container :

      • iPlanet Web Serverの場合

        Please choose ServletContainer
        (J)Run4,(i)Planet :

      • Sun ONE Web Serverの場合

        Please choose ServletContainer
        (J)Run4,(W)ebOTX Web Container,(S)unONE :

      • WebOTX Web Serverの場合

        Please choose ServletContainer
        (J)Run4,(W)ebOTX Web Container :

      選択肢には、OSやWebサーバによって選択可能なものが表示されます。
      使用するServletコンテナの種類を選択肢から選んで、()の中の文字を入力してください。

   5. Servletコンテナのディレクトリの設定

      • JRun4の場合

        Please input JRun4 installation directory (/opt/jrun4)[]:

        Please input JRun4 Server Directory (.../servers/default):

      • WebOTX Webコンテナの場合

        Please input ServletContainer Directory [/opt/WebOTX/domains/domain1]:

      • Sun ONE Web Serverの場合

        Please input SunONE Server Directory (.../servers/https-***) :

      • iPlanet Web Serverの場合

        Please input iPlanet Server Directory (.../server4/https-***) :

      Servletコンテナのサーバディレクトリを指定してください。
      JRun4.0を使用する場合は、最初のメッセージでJRunのインストールディレクトリを聞かれますので、入力してください。次のメッセージで、サーバディレクトリを入力してください。

   6. 仮想サーバIDの設定（Sun ONE Web Serverの内蔵コンテナの場合）

      Please input SunONE VirtualServer Name (https-....)[https-***]:

      Sun ONE Web Serverの内蔵コンテナを使用する場合は、仮想サーバIDを入力してください。
      
      既定値：https-(Webサーバ名)

   7. JDKのバージョンの設定

      Please input JDK installation directory [/opt/java]:
      使用するJDKのインストールディレクトリを入力してください。

      JDK Version Check...{（JDKのバージョン）}
      Is this version number of above correct? [y/n]:
      表示されたJDKのバージョンが正しければ、yを入力してください。yを入力した場合は、次の設定に進みます。nを入力した場合は、以下のメッセージが出力され、JDKのバージョンの入力を問われます。

      Please input JDK Version (1.3 , 1.4):
      使用するJDKのバージョンを()の中から選択して文字を入力してください。
      

   8. Servletコンテナの起動ユーザの設定

      Please input Servlet Container User ID [root]:

      Servletコンテナの起動ユーザを入力してください。すでにセットアップされているServletコンテナのユーザIDに従ってください。
      既定値：root

   9. Servletコンテナの起動ユーザのグループ名の設定

      Please input Servlet Container Group ID [sys]:

      Servletコンテナの起動ユーザのグループ名を入力してください。すでにセットアップされているServletコンテナのグループ名に従ってください。
      既定値：sys

   10. Object Brokerのバージョンの設定（JRun、iPlanet Web Server、Sun ONE Web Serverの場合のみ）

       Please input Object Broker Version [5.1 or over]
       (4).5 , (5).1 or over :

       使用するObject Brokerのバージョンが4.5か5.1以上かを選択して、()の中の文字を入力してください。
       ObjectSpinnerの互換ライブラリ（ObjectSpinnerバージョン5.x以上に含まれているObjectSpinnerバージョン4.5との互換用ライブラリ）を使用する場合は、4.5を選んでください。
       WebOTX Webコンテナの場合は、自動的にObject Brokerバージョン8.xになります。
       既定値：5.1 or over

   11. WebAP JSPルートディレクトリの設定

       Please enter WebOTX WebAP JSP root directory.[(WebAP JSPインストールディレクトリ)]:
       

       WebAP JSPが動作するディレクトリを指定します。使用するServletコンテナがJRun、Sun ONE Web Server、Webコンテナの場合に指定可能です。
       既定値：/opt/WebOTXJSP/Runtime

6. 必要な情報の入力が完了すると、確認画面を表示します。

   ----- WebServer Setting ------------- WebServer Name : Webサーバ名 Document Dir: Webサーバのドキュメントルートディレクトリ ----- ServletContainer Setting ------ ServletContainer : Servletコンテナ名 Install Dir : Servletコンテナのディレクトリ JDK Version : JDKのバージョン JRE Dir : JREのディレクトリ USER ID : ユーザ名 GROUP ID : グループ名 VirtualServer Name : 仮想サーバID <-Sun ONE Web Serverの場合のみ ----- WebAP JSP Setting ------------- Root Directory : WebAP JSPのルートディレクトリ Object Broker Version: Object Brokerのバージョン Are all of above correct?[y/n] :

   
   
   

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

7. ServletコンテナとしてiPlanet Web Serverを使用する場合は、以下のメッセージが表示されます。

   After this program,please setup JDK Configuration on iPlanet. At that time , you might use the following classpath. ----------------------- Option: JavaVMのオプション ----------------------- Classpath: クラスパス -----------------------

   ServletコンテナとしてiPlanetを使用する場合は、環境設定ツール使用後に、iPlanet Web Serverの管理用ホームページから、クラスパスなどの設定を行う必要があります。JavaVMのオプションとクラスパスに設定する情報は、上記のメッセージを参照してください。

8. 次のメッセージが出たら環境設定完了です。

   Setting is completed. Thank you.

   途中でエラーになった場合は、エラーメッセージに従って問題を解決後、再度setconf.shを実行してください。

環境設定ツール使用時の注意事項については、「注意制限事項」の「実行環境」の「環境設定ツール」を参照してください。

WebAP JSPはWARファイルとしてServletコンテナに配備するだけで動作可能となります。WARファイル作成ツールは、そのWARファイルを実行環境インストールディレクトリ配下のmakewar.exe（makewar.sh）コマンドに適切なオプションを指定し実行することにより作成します。

カレントディレクトリをWebAP JSPインストールディレクトリに移動した後、次のように指定してmakewarコマンドを実行してください。オプションについてはその下の説明を参照してください。

• Windows版
  makewar jarpath runtimedir ospiver rootdir containerName

• HP-UX版/Linux版
  sh ./makewar.sh jarpath runtimedir ospiver rootdir containerName

WARファイル作成ツールの実行が正常に終了すると、以下の場所にOTXJSP.warファイルができます。

実行環境インストールディレクトリ/webap/OTXJSP.war

（例）
以下の例は、JDK 1.4、Webコンテナ、Object Broker標準ライブラリを使用する場合で、WebAP JSPルートディレクトリがWindows版は「C:\JSPROOT\Runtime」、HP-UX版/Linux版は「/home/JSPROOT/Runtime」の場合です。

• Windows版

  makewar C:\jdk1.4\bin\jar "C:\Program Files\NEC\WebOTX\JSP\Runtime" st "C:\JSPROOT\Runtime" webcont40

• HP-UX版/Linux版

  sh ./makewar.sh /opt/java1.4/bin/jar /opt/WebOTXJSP/Runtime st /home/JSPROOT/Runtime webcont40

WebAP JSPは運用管理画面JSPファイル（admin.jsp）および業務閉塞用JSPファイル（transcntl.jsp）を提供しております。少なくともこれらのJSPファイルに対しては管理者のみがアクセス可能にする必要があります。WebOTX Webコンテナを使用する場合には、標準でBASIC認証によるユーザ認証が行われます。

その他のWebサーバ・Webコンテナの組み合わせの場合は手動にてセキュリティ設定を行ってください。
どのセキュリティ設定を実際に使用されるかは、ご使用になるシステム要件に応じて決定してください。

ここでは、WebAP JSPの管理者用JSPファイルが含まれるディレクトリ（jspadmin）に対する推奨されるアクセス制限方法を説明します。

■JRun4.0をServletコンテナとして使用する場合

JRunの機能を使用し、Webブラウザからのリクエスト「/OTXJSP/jspadmin/*」を管理者権限「admin」を持つユーザにのみ許可します。JRunは認証方式としてBASICとFORMを実装していますが、ここではBASIC認証を使用します。

JRun4.0用の雛形web.xmlファイル、

WebAP JSPインストールディレクトリ\webap\default\web-jrun4.xml

を以下のように修正後、環境設定ツールなどで環境設定を行ってください。

<security-constraint>から</login-config>まで（赤字の箇所）がセキュリティ設定のために追加した記述です。
この記述はweb-jrun4.xmlの中にすでにコメント行として含まれています。

<?xml version="1.0" encoding="ISO-8859-1"?>

<web-app>
<filter>
<filter-name>jspFilter</filter-name>
<filter-class>jp.co.nec.webapjsp.run.CharEncodeFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>jspFilter</filter-name>
<servlet-name>RUN</servlet-name>
</filter-mapping>

<servlet>
<servlet-name>RUN</servlet-name>
<servlet-class>jp.co.nec.webapjsp.run.ServletRun</servlet-class>
<init-param>
<param-name>INSTDIR</param-name>
<param-value>%INSTDIR%</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>RUN</servlet-name>
<url-pattern>/RUN</url-pattern>
</servlet-mapping>

<security-constraint>
  <web-resource-collection>
    <web-resource-name>WebAP JSP Application</web-resource-name>
    <url-pattern>/jspadmin/*</url-pattern>
  </web-resource-collection>
  <auth-constraint>
    <role-name>admin</role-name>
  </auth-constraint>
</security-constraint>

<login-config>
  <auth-method>BASIC</auth-method>
  <realm-name>WebAP JSP</realm-name>
</login-config>

</web-app>

「admin」のroleはJRunに登録されている必要があります。roleの登録方法については、JRun4.0のマニュアル「JRun プログラマーガイド」の「Web アプリケーションのセキュリティ 」をご覧ください。

■WebOTX WebコンテナをServletコンテナとして使用する場合

WebOTX Webコンテナ用の雛形web.xmlファイル、

WebAP JSPインストールディレクトリ\webap\default\web-webcont40.xml（別途nec-web.xmlが必要）
には、あらかじめ以下のようなセキュリティ設定の記述が入っています。
そのため、環境設定ツールなどで環境設定を行うと、自動的にBASIC認証のアクセス制限が設定されます。ブラウザから運用管理画面（/OTXJSP/jspadmin/admin.jsp)にアクセスするとダイアログが表示されますので、ユーザ名「admin」、パスワード「adminadmin」を入力してください。ユーザ名、パスワードはWebOTX Webコンテナの設定により変更可能です。変更する場合は「Webコンテナのユーザ名とパスワードの変更」を参照してください。業務閉塞用コマンドを実行する場合は、ユーザ名とパスワードをHttpAccessコマンドの起動時オプションに追加してください。

<security-constraint>から</login-config>まで（赤字の箇所）がセキュリティ設定の記述です。

<?xml version="1.0" encoding="ISO-8859-1"?>

    <!DOCTYPE web-app
    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
    "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<web-app>
<servlet>
<servlet-name>RUN</servlet-name>
<servlet-class>jp.co.nec.webapjsp.run.ServletRun</servlet-class>
<init-param>
<param-name>INSTDIR</param-name>
<param-value>%INSTDIR%</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>RUN</servlet-name>
<url-pattern>/RUN</url-pattern>
</servlet-mapping>

<security-constraint>
  <web-resource-collection>
    <web-resource-name>WebAP JSP Application</web-resource-name>
    <url-pattern>/jspadmin/*</url-pattern>
  </web-resource-collection>
  <auth-constraint>
    <role-name>admin</role-name>
  </auth-constraint>
</security-constraint>

<login-config>
  <auth-method>BASIC</auth-method>
  <realm-name>WebAP JSP</realm-name>
</login-config>

<security-role>
  <description>
    The role that is required to log in to the Administration Application
  </description>
    <role-name>admin</role-name>
</security-role>

</web-app>

＜Webコンテナのユーザ名とパスワードの変更＞

Webコンテナのユーザ名とパスワードを変更したい場合は、Webコンテナの設定ファイルを直接修正します。設定ファイルは、Webコンテナのインストールディレクトリ/conf 配下にある tomcat-users.xml です。このファイルの以下の行の　name と password を変更した後、Webコンテナ(ドメイン)を再起動してください。

<user name="Admin" password="webotx.com" roles="admin,manager" />

■iPlanet4.1をWebサーバとして使用する場合

iPlanet4.1のアクセス コントロール リスト (ACL) を使用してアクセス制限を行います。ACLでは多様なアクセス制限を行うことが可能ですが、ここでは特定のマシンからのアクセスのみを許可する方法を説明します。

1. iPlanetの管理用ホームページにアクセスします。

2. 使用するWebサーバを選択し、「Preferences」の「Restrict Access」を選択します。

3. 「A. Pick a resource」の「Editing」にiPlanetのドキュメントルート配下の「jspadmin」を選択します。

4. 「New Line」を選択し、「Access Control Rules」を選択します。

5. システムに応じて拒否する条件「Deny」と許可する条件「Allow」を設定します。

   以下に設定例を示します。

   Access Control Rules for : path=C:/Netscape/Server4/docs/jspadmin/
   	Action	Users/Groups	From Host	Rights	Extra	Continue
   1	Deny	anyone	anyplace	all	x	チェック
   2	Allow	anyone	管理者のマシン	all	x	チェック

   上記の場合、管理者のマシンのIPアドレスのみアクセス許可されます。

■Sun ONE Web Server6.0をWebサーバとして使用する場合

Sun ONE Web Server6.0のアクセス コントロール リスト (ACL) を使用してアクセス制限を行います。ACLでは多様なアクセス制限を行うことが可能ですが、ここでは特定のマシンからのアクセスのみを許可する方法を説明します。

1. Sun ONE Web Server6.0の「Administration Server」ページにアクセスします。

2. 使用するWebサーバを選択し、「Preferences」の「Restrict Access」を選択します。

3. 「Option」の「Edit」を選択して、「OK」ボタンをクリックすると、「Access Control List Management」ページが開きます。

4. 「A. Pick a resource」の「Editing」に「Sun ONE Web Serverのサーバディレクトリ/OTXJSP/jspadmin/*」を設定します。

5. 「Edit Access Control」ボタンをクリックして表示された画面で、「New Line」ボタンをクリックするとリストに新しい設定が追加されます。

6. システムに応じて拒否する条件「Deny」と許可する条件「Allow」を設定します。

   以下に設定例を示します。

   Access Control Rules for : path=C:/SunONE60/servers/https-hostname/OTXJSP/spadmin/
   	Action	Users/Groups	From Host	Rights	Extra	Continue
   1	Deny	anyone	anyplace	all	x	チェック
   2	Allow	anyone	管理者のマシン	all	x	チェック

   上記の場合、管理者のマシンのIPアドレスのみアクセス許可されます。

■WebOTX WebServerまたはApacheをWebサーバとして使用する場合

Apacheでは多様なアクセス制限を行うことが可能です。ここでは特定のマシンからのアクセスのみを許可する方法を説明します。ApacheのLocation指示子によりアクセス制限を行います。

1. httpd.confのLocation指示子に以下を追加します。

   <Location /OTXJSP/jspadmin/*> Deny from all Allow from IPアドレス </Location>

   上記の場合、管理者のマシンのIPアドレスのみアクセス許可されます。

WebAP JSPインストールディレクトリには、Servletコンテナの種類ごとに雛形のweb.xmlファイルが格納されています。

web.xmlを変更してセキュリティ設定などの記述を加えたい場合は、雛形web.xmlを変更してから環境設定ツールやWARファイル作成ツールを実行してください。作成されるWARファイル中のweb.xmlに自動的に変更が反映されます。雛形web.xmlを変更する場合は、オリジナルのファイルを待避しておくことをお勧めします。

雛形web.xmlの格納されている場所と、対応するServletコンテナの種類は以下のとおりです。

WebAP JSPインストールディレクトリ\webap\default配下

WebAP JSP が動作可能なモアレッシモとServletコンテナの組み合わせのパターンは以下のとおりです。Webサーバは、WebAP JSPがサポートしている組み合わせであれば種類は問いません。
モアレッシモ1.xではHP-UXをサポートしていません。
モアレッシモでは、Linux、64bit用Windows、IPF用HP-UXをサポートしていません。

以下では、それぞれのパターンについて、設定方法を説明します。

＜Windows版＞

• モアレッシモ2.0とWebOTX Webコンテナを使用する場合

＜HP-UX版＞

• モアレッシモ2.0とWebOTX Webコンテナを使用する場合

以下の手順で設定を行ってください。

1. WebサーバとWebコンテナの環境設定を行ってください。設定方法は、「3.2.1 WebサーバとServletコンテナの環境設定 Windows版」の各Webサーバに対応した記述を参照してください。
   設定が完了すると、Webコンテナインストールディレクトリ\webapps配下に、OTXJSPというディレクトリができます。以下では「OTXJSPディレクトリ」と呼びます。

2. WebOTX Webコンテナの運用管理コンソールを起動し、「Java設定」の「Java VM の引数」の-Xbootclasspathオプションに設定されている、以下のJarファイルへのパスを削除してください。
   

   • xercesImpl.jar
   • xmlParserAPIs.jar

3. モアレッシモ用のエラー表示JSPファイル（runerr_moire.jsp）の設定を行ってください。また、業務閉塞機能を使用する場合は、受け付け停止中のリダイレクト先JSPファイル（disable.jsp）を修正してください。これらのJSPファイルの設定方法は、「モアレッシモ連携用JSPファイルの設定」を参照してください。

4. Webサーバと、Webコンテナ(ドメイン)を停止してください。

5. WebAP JSPのweb.xmlファイルを待避してください。web.xmlファイルは以下の場所にあります。

   Webコンテナインストールディレクトリ\webapps\OTXJSP\WEB-INF\web.xml

   
   

6. OTXJSPディレクトリにモアレッシモのmoire.warファイルを展開してください。以下の例は、moire.warファイルが「c:\moire.war」にある場合です。

   cd Webコンテナインストールディレクトリ\webapps\OTXJSP jar xf c:\moire.war

   
   

7. OTXJSPディレクトリ\WEB-INF\web.xmlはモアレッシモのweb.xmlで上書きされるので、待避しておいたWebAP JSPのweb.xmlの設定を追加します。

   以下に例を示します。赤字の部分が追加した記述です。以下の例はWebAP JSPルートディレクトリが「C:\Program Files\NEC\WebOTX\JSP\Runtime」の場合です。
   web.xml中のタグを記述する順番が入れ替わると、Webコンテナ起動時にエラーになる場合があるので、記述位置を間違えないように注意してください。

   <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2.2.dtd"> <web-app> <context-param> <param-name>weblogic.httpd.inputCharset./sample/*</param-name> <param-value>iso-8859-1</param-value> </context-param> <servlet> <servlet-name>RUN</servlet-name> <servlet-class>jp.co.nec.webapjsp.run.ServletRun</servlet-class> <init-param> <param-name>INSTDIR</param-name> <param-value>C:\\Program Files\\NEC\\WebOTX\\JSP\\Runtime</param-value> </init-param> </servlet> <servlet> <servlet-name>Moire</servlet-name> <servlet-class>jp.co.nec.moire.cocoon.Moire</servlet-class> <init-param> <param-name>properties</param-name> <param-value>/WEB-INF/moire.properties</param-value> <!-- <param-value>/WEB-INF/moire_chtml.properties</param-value> --> </init-param> </servlet> <servlet> <servlet-name>MyServlet</servlet-name> <servlet-class>MyServlet</servlet-class> </servlet> <servlet> <servlet-name>PostParamServlet</servlet-name> <servlet-class>PostParamServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>RUN</servlet-name> <url-pattern>/RUN</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>Moire</servlet-name> <url-pattern>*.xml</url-pattern> <!-- <url-pattern>*.html</url-pattern> --> </servlet-mapping> <servlet-mapping> <servlet-name>Moire</servlet-name> <url-pattern>/dispatch2moire</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>MyServlet</servlet-name> <url-pattern>/sample/MyServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>PostParamServlet</servlet-name> <url-pattern>/sample/form/postparam</url-pattern> </servlet-mapping> <mime-mapping> <extension>png</extension> <mime-type>image/png</mime-type> </mime-mapping> <mime-mapping> <extension>bmp</extension> <mime-type>image/bmp</mime-type> </mime-mapping> <taglib> <taglib-uri>http://moire.isd.nec.co.jp/jsp</taglib-uri> <taglib-location>/WEB-INF/moire.tld</taglib-location> </taglib> <security-constraint> <web-resource-collection> <web-resource-name>WebAP JSP Application</web-resource-name> <url-pattern>/jspadmin/*</url-pattern> </web-resource-collection> <auth-constraint> <role-name>admin</role-name> </auth-constraint> </security-constraint> <login-config> <auth-method>BASIC</auth-method> <realm-name>WebAP JSP</realm-name> </login-config> </web-app>

   
   

8. 設定が終了したら、Webサーバ、Webコンテナ(ドメイン)を起動してください。

以下の手順で設定を行ってください。

1. WebサーバとWebコンテナの環境設定を行ってください。設定方法は、「3.2.2 WebサーバとServletコンテナの環境設定 HP-UX版/Linux版」の各Webサーバに対応した記述を参照してください。
   設定が完了すると、Webコンテナインストールディレクトリ/webapps配下に、OTXJSPというディレクトリができます。以下では「OTXJSPディレクトリ」と呼びます。

2. WebOTX Webコンテナの運用管理コンソールを起動し、「Java設定」の「Java VM の引数」の-Xbootclasspathオプションに設定されている、以下のJarファイルへのパスを削除してください。
   

   • xercesImpl.jar
   • xmlParserAPIs.jar

3. モアレッシモ用のエラー表示JSPファイル（runerr_moire.jsp）の設定を行ってください。また、業務閉塞機能を使用する場合は、受け付け停止中のリダイレクト先JSPファイル（disable.jsp）を修正してください。これらのJSPファイルの設定方法は、「モアレッシモ連携用JSPファイルの設定」を参照してください。

4. Webサーバと、Webコンテナ(ドメイン)を停止してください。

5. WebAP JSPのweb.xmlファイルを待避してください。web.xmlファイルは以下の場所にあります。

   Webコンテナインストールディレクトリ/webapps/OTXJSP/WEB-INF/web.xml

   
   

6. OTXJSPディレクトリにモアレッシモのmoire.warファイルを展開してください。以下の例は、moire.warファイルが「/tmp/moire.war」にある場合です。

   cd Webコンテナインストールディレクトリ/webapps/OTXJSP jar xf /tmp/moire.war

   
   

7. OTXJSPディレクトリ\WEB-INF\web.xmlはモアレッシモのweb.xmlで上書きされるので、待避しておいたWebAP JSPのweb.xmlの設定を追加します。

   以下に例を示します。赤字の部分が追加した記述です。以下の例はWebAP JSPルートディレクトリが「/opt/WebOTXJSP/Runtime」の場合です。
   web.xml中のタグを記述する順番が入れ替わると、Webコンテナ起動時にエラーになる場合があるので、記述位置を間違えないように注意してください。

   <?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" "http://java.sun.com/j2ee/dtds/web-app_2.2.dtd"> <web-app> <context-param> <param-name>weblogic.httpd.inputCharset./sample/*</param-name> <param-value>iso-8859-1</param-value> </context-param> <servlet> <servlet-name>RUN</servlet-name> <servlet-class>jp.co.nec.webapjsp.run.ServletRun</servlet-class> <init-param> <param-name>INSTDIR</param-name> <param-value>/opt/WebOTXJSP/Runtime</param-value> </init-param> </servlet> <servlet> <servlet-name>Moire</servlet-name> <servlet-class>jp.co.nec.moire.cocoon.Moire</servlet-class> <init-param> <param-name>properties</param-name> <param-value>/WEB-INF/moire.properties</param-value> <!-- <param-value>/WEB-INF/moire_chtml.properties</param-value> --> </init-param> </servlet> <servlet> <servlet-name>MyServlet</servlet-name> <servlet-class>MyServlet</servlet-class> </servlet> <servlet> <servlet-name>PostParamServlet</servlet-name> <servlet-class>PostParamServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>RUN</servlet-name> <url-pattern>/RUN</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>Moire</servlet-name> <url-pattern>*.xml</url-pattern> <!-- <url-pattern>*.html</url-pattern> --> </servlet-mapping> <servlet-mapping> <servlet-name>Moire</servlet-name> <url-pattern>/dispatch2moire</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>MyServlet</servlet-name> <url-pattern>/sample/MyServlet</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>PostParamServlet</servlet-name> <url-pattern>/sample/form/postparam</url-pattern> </servlet-mapping> <mime-mapping> <extension>png</extension> <mime-type>image/png</mime-type> </mime-mapping> <mime-mapping> <extension>bmp</extension> <mime-type>image/bmp</mime-type> </mime-mapping> <taglib> <taglib-uri>http://moire.isd.nec.co.jp/jsp</taglib-uri> <taglib-location>/WEB-INF/moire.tld</taglib-location> </taglib> <security-constraint> <web-resource-collection> <web-resource-name>WebAP JSP Application</web-resource-name> <url-pattern>/jspadmin/*</url-pattern> </web-resource-collection> <auth-constraint> <role-name>admin</role-name> </auth-constraint> </security-constraint> <login-config> <auth-method>BASIC</auth-method> <realm-name>WebAP JSP</realm-name> </login-config> </web-app>

   
   

8. 設定が終了したら、Webサーバ、WebOTX Webコンテナ(ドメイン)を起動してください。

1. エラー表示用JSPファイル（runerr_moire.jsp）の設定

   モバイル端末にエラーを表示できるようにするため、エラー表示用JSPファイルとして、通常のrunerr.jspではなくrunerr_moire.jspを設定する必要があります。以下の手順に従って設定してください。

   1. 運用管理／環境設定用JSPファイル（admin.jsp)を実行します。Webブラウザから以下のURLを実行して、「運用状態表示」ページを表示してください。

      http://Webサーバ名:ポート番号/OTXJSP/jspadmin/admin.jsp

   2. 「環境設定」ボタンをクリックして「環境設定」ページを表示してください。
      「起動時オプション」の「エラー発生時に表示するJSP名」を修正します。
      初期設定では、「/jsp/runerr.jsp」となっています。これを「/jsp/runerr_moire.jsp」に修正して、「更新」ボタンをクリックしてください。

   注意：runerr_moire.jspをカスタマイズして、独自のエラー表示用JSPファイルを作成する場合は、「HTMLファイルの記述形式」を参照して、モアレッシモに対応した形式で記述してください。

2. 受け付け停止中のリダイレクト先JSPファイル（disable.jsp）の修正

   業務閉塞機能を使用する場合は、disable.jspにモアレッシモ用の記述を追加してください。

   disable.jspは以下の場所にあります。

   • ServletコンテナがWebOTX Webコンテナの場合

     Webコンテナインストールディレクトリ/webapps/OTXJSP/jsp/disable.jsp

   以下の例で赤字で記述している部分（先頭の２行、最後の１行）をdisable.jspに追加します。

   <%@ taglib uri="http://moire.isd.nec.co.jp/jsp" prefix="moirejsp" %><%-- --%><moirejsp:translate uri="/dispatch2moire"> <%@ page import="java.io.*" %> ------------------------- <HTML> ------------------------- </HTML> </moirejsp:translate>

   注意：disable.jspをカスタマイズして、独自のリダイレクト先JSPファイルを作成する場合は、「HTMLファイルの記述形式」を参照して、モアレッシモに対応した形式で記述してください。

WebAP JSP Developer からWebAP JSPに転送されたWebアプリケーションを、以下の手順で実行してください。

Webブラウザから、実行するトランザクションのURLにアクセスしてください。

MFDL移行の場合は、最初に実行するフェーズ名は固定（メニュー画面を表示するフェーズ）です。

上記の各 URLの緑色の部分は、JSP開発ツールのメインパネルに表示される、「最初に実行可能なフェーズ名」のURLを指定してください。

注意：WebAP JSPは、大文字／小文字を区別します。URL指定時は、大文字／小文字を間違えないように正しく指定してください。

WebAP JSPでは、Webブラウザで運用状態の表示を行うことができます。したがって、リモートマシンからWebAP JSPの運用状態を確認することもできます。
運用状態を表示するには、以下のURLを指定して「運用状態表示」ページを表示します。

「運用状態表示」ページのイメージを以下に示します。

各項目の説明を以下に示します。

注意：長時間の測定を行った場合、データあふれを防ぐため、それまでに測定したデータをWebAP JSP内部でクリアする場合があります。

WebAP JSPでは、Webブラウザでファイル転送サーバの起動・停止・設定を行うことができます。したがって、リモートマシンからWebAP JSPのファイル転送サーバの起動・停止・設定を行うこともできます。
ファイル転送サーバの起動・停止・設定の手順を以下に示します。

「運用状態表示」ページで、「ファイル転送」ボタンをクリックすると以下のような「ファイル転送」ページを表示します。

各項目の説明を以下に示します。
なお、詳細は「ファイル転送」ページの画面上で「説明」ボタンをクリックして表示されるドキュメントを参照してください。

ファイル転送サーバの起動・停止

ファイル転送サーバの設定

設定内容を変更した場合は、「更新」ボタンをクリックしてください。

111.112.113.1,111.114

補足

• ファイル転送サーバ起動中に、ポート番号を指定して「更新」ボタンをクリックした場合、ファイル転送サーバを指定のポート番号で再起動します。
• ファイル転送サーバ起動中に、ポート番号を削除して「更新」ボタンをクリックした場合、ファイル転送サーバを停止します。
• ファイル転送サーバでエラーが発生した場合、エラーログファイルにその内容を出力します。
  ただし、エラーログの発生時刻の次に出力されるクライアントのIPアドレスは「null」となります。
• 自動起動を「する」に設定する場合、ポート番号を指定しなければなりません。ポート番号を指定していない状態で、「する」を指定しても、更新時に「しない」に設定します。

WebAP JSPでは、業務閉塞機能（プロジェクト、トランザクションごとに、使用状況の確認、新規実行要求の受け付け停止／開始、セッションの解放などを行う機能）をサポートしています。これらの運用管理はWebブラウザから行うことができます。したがって、リモートマシンからWebAP JSPの運用管理を行うこともできます。

WebアプリケーションやサーバAPを置き換える場合は、影響するプロジェクト、トランザクションについて、新規実行要求の受け付け停止（以下、「新規受け付け停止」と表記します）を行い、必要ならセッションの解放を行うなどして、使用中のセッションがないことを確認してからAPの置換を行ってください。その後、新規実行要求の受け付け開始（「以下、「新規受け付け開始」と表記します）を行います。
APの置換手順の詳細については、「APの置換手順」を参照してください。

「運用管理」ページの使用手順を以下に示します。

「運用状態表示」ページで、「運用管理」ボタンをクリックすると以下のような「運用管理」ページを表示します。

「運用管理」ページは、プロジェクトやトランザクションの使用状況の表示、変更を行う「実行環境のプロジェクト」エリアと、受け付け停止中のトランザクションに関する設定を行う「停止中のトランザクションに関する設定」エリアに別れています。
各項目の説明を以下に示します。
なお、詳細は「運用管理」ページの画面上で「説明」ボタンをクリックして表示されるドキュメントを参照してください。

「実行環境のプロジェクト」エリア

「停止中のトランザクションに関する設定」エリア

設定内容を変更した場合は、「更新」ボタンをクリックしてください。
WebAP JSPを再起動すると、設定した値をWebAP JSPに反映します。ServletコンテナとしてJRunを使用している場合は、JRunを再起動してください。ServletコンテナとしてiPlanet Web Serverを使用している場合は、Webサーバを再起動してください。

詳細使用状況ウィンドウ

「運用管理ページの「使用状況」欄中の「詳細」ボタンをクリックすると以下のような「詳細使用状況ウィンドウ」を表示します。

各項目の説明を以下に示します。ウィンドウを終了するには、「閉じる」ボタンをクリックしてください。

APの置換手順

運用中のサーバAPおよびWebAP JSPのWebアプリケーションの置換を行うときは、以下の手順に従ってください。

運用管理／環境設定用JSPファイル（admin.jsp）の「運用管理」ページで行う、新規実行要求の受け付け停止／開始等の業務閉塞処理を、HTTPアクセスコマンドからも実行することができます。

「Webサーバの環境設定」を参照して、HTTPアクセスコマンドの実行結果を返却するための業務閉塞用JSPファイル（transcntl.jsp）をWebサーバからアクセス可能にしておいてください。

HTTPアクセスコマンドの使用方法を以下に示します。

以下に、HTTPアクセスコマンドのURLパラメータの一覧を示します。

HTTPアクセスコマンドが正常終了すると、戻り値"0"を返却します。異常終了すると、戻り値"1"を返却します。Webサーバからのレスポンスメッセージはすべて標準出力します。

リクエストの受け付け停止を行うと、新規受け付けだけでなく、使用中のWebクライアントからのリクエストも受け付けなくなります。
管理者以外のすべてのアクセスを拒否したい場合は、リクエストの受け付け停止を行ってください。
リクエスト受け付け停止を行った後、PROJSTARTによりプロジェクトのリクエストの受け付け開始を、TRSTARTによりトランザクションのリクエストの受け付け開始を行うことができます。

APの置換手順

運用中のWebAP JSPのWebアプリケーションの置換を行う場合に、HTTPアクセスコマンドを使用して業務閉塞処理を行う手順を以下に示します。（以下の例では、プロジェクト名=proj、トランザクション名=tranとします。）

WebAP JSPでは、Webブラウザで環境設定を行うことができます。したがって、リモートマシンからWebAP JSPの環境設定を行うこともできます。
環境設定の手順を以下に示します。

「運用状態表示」ページで、「環境設定」ボタンをクリックすると以下のような起動時オプションの項目を表示します。

各項目の説明を以下に示します。
なお、詳細は起動時オプションの画面上で「説明」ボタンをクリックして表示されるドキュメントを参照してください。

設定内容を変更した場合は、「更新」ボタンをクリックしてください。
WebAP JSPを再起動すると、設定した値をWebAP JSPに反映します。ServletコンテナとしてJRunを使用している場合は、JRunを再起動してください。ServletコンテナとしてiPlanet Web Serverを使用している場合は、Webサーバを再起動してください。

UTF8,ISO8859-1

OSF_SJIS1

OSF_SJIS1=MS932

＜ServletコンテナとしてiPlanetを使用する場合のマルチバイトのUNICODE変換について＞

ServletコンテナとしてiPlanet Web Server 4.1を使用する場合、Webブラウザから取得したマルチバイト文字を正しくUNICODE変換するためには、以下の２つを適切に設定する必要があります。

• iPlanetのWebサーバディレクトリ配下のconfig/contexts.propertiesファイルのcontext.global.parameterEncoding


• 「環境設定」ページの「起動オプション」の「wstringのUNICODE変換 」および「stringのUNICODE変換」

UNICODE変換をiPlanetの機能により行う場合は以下のように設定します。

• context.global.parameterEncoding=auto
• 「wstringのUNICODE変換 」は「行わない」を指定
• 「stringのUNICODE変換 」は「行わない」を指定

UNICODE変換をWebAP JSPの機能により行う場合は以下のように設定します。

• context.global.parameterEncoding=none
• 「wstringのUNICODE変換 」は「行う」を指定
• 「stringのUNICODE変換 」は、string型の入力引数を使用してマルチバイト文字を送信する場合のみ「行う」を指定、それ以外の場合は「行わない」を指定
• iPlanetのSP番号によってはcontext.global.parameterEncodingに直接「ISO8859_1」などのエンコーディング名を指定する必要があります。

WebAP JSP開発部門にて確認した範囲では、iPlanetのSP番号により以下の違いがあります。

----------------------------------
SP2（日本語版）及びSP5（日本語版）
----------------------------------

• context.global.parameterEncoding=none
• 「wstringのUNICODE変換 」は「行う」を指定
• 「stringのUNICODE変換 」は、string型の入力引数を使用してマルチバイト文字を送信する場合のみ「行う」を指定、それ以外の場合は「行わない」を指定

----------------------------------
SP7（英語版）
----------------------------------

• context.global.parameterEncoding=auto
• 「wstringのUNICODE変換 」は「行わない」を指定
• 「stringのUNICODE変換 」は「行わない」を指定

----------------------------------
SP8
----------------------------------

• context.global.parameterEncoding=ISO8859_1
• 「wstringのUNICODE変換 」は「行う」を指定
• 「stringのUNICODE変換 」は、string型の入力引数を使用してマルチバイト文字を送信する場合のみ「行う」を指定、それ以外の場合は「行わない」を指定

----------------------------------

詳しくは、iPlanetのマニュアルを参照してください。

「運用状態表示」ページで、「環境設定」ボタンをクリックして表示されるページを下方向にスクロールすると、以下のようなコンフィグレーションの項目を表示します。

　コンフィグレーションの各項目は、すべて省略不可です。各項目の説明を以下に示します。
　設定内容を変更した場合は、「更新」ボタンをクリックしてください。設定した値をWebAP JSPに反映します。

ログファイルの詳細情報については、「WebOTX WebAP JSP メッセージ編 実行環境」を参照してください。