NEC Mark
WebOTX Manual V10.3 (第4版)

アプリケーションの開発: WebOTX Developer Manual 目次を表示

5. サーバツール

5.1. サーバ構成の操作

5.1.1. サーバランタイム

5.1.1.1. サーバランタイムの追加
具体的な、サーバランタイムの追加手順については、 [ 環境設定 > テスト用サーバの設定 > WebOTXランタイムの設定 ] に説明していますので、ご覧ください。

ここでは、追加可能なランタイムの種類について説明します。
追加可能なランタイムの種類は、次の表に示すように、Developer(with Developer's Studio)と 同じマシンにインストールされたWebOTX サーバ製品により決定します。
表6.1.1.1-1
ランタイム環境のタイプ Developer(with Developer's Studio)と同じマシンにインストールされたWebOTXサーバ製品
Application Server
(Express/Standard/Enterprise/テスト用サーバ)		 ESB +
Application Server		 Portal
単独		 無し
WebOTX Application Server(Local) ○ ○ ○ -
WebOTX ESB(Local) - ○ - -
WebOTX Portal(Local) - - ○ -
WebOTX Application Server(Remote) ○
WebOTX ESB (Remote)
WebOTX Portal(Remote)

Memo
製品にESB,Portalサーバが含めない場合、 ESB,Portalサーバラインタイムを利用できません。

5.1.2. サーバ

5.1.2.1. サーバの新規作成
具体的な、サーバの新規作成 の手順については、 [ 環境設定 > テスト用サーバの設定 > WebOTXサーバーの新規作成 ] に説明していますので、ご覧ください。

ここでは、新規作成可能なサーバの種類について説明します。

新規作成可能なサーバの種類は、次の表に示すように、Developer(with Developer's Studio)と同じマシンにインストールされたWebOTX サーバ製品により決定します。
表6.1.2.1-1
サーバのタイプ Developer(with Developer's Studio)と同じマシンにインストールされたWebOTXサーバ製品
Application Server
(Standard/Enterprise)		 Application Server
(Express/テスト用サーバ)		 無し
WebOTX Application Server(Local) WebOTX Application Server
    Standard/Enterprise		 WebOTX Application Server Express -
WebOTX ESB(Local)
WebOTX Portal(Local)
WebOTX Application Server(Remote) ・WebOTX Application Server Express
・WebOTX Application Server Standard/Enterprise
※ いずれかを選択可能
WebOTX ESB(Remote)
WebOTX Portal(Remote)
(Local) のサーバを新規作成する場合、サーバの種別にはインストールされているサーバ製品により確定するため、 表示されたものを変更する事はできません。 (Remote) の場合は、２つの候補のいずれかを選択する事ができます。
5.1.2.2. サーバの設定の編集方法
サーバの Overview 画面から、サーバに関する各種設定内容を編集することができます。
  1. メニューの ウィンドウ ＞ ビューの表示 ＞ サーバー を選択します。


    図6.1.2.2-1

  2. サーバー タブ内の編集対象のサーバを、ダブルクリックします。


    図6.1.2.2-2

  3. 開いたサーバの編集画面で、設定を編集することができます。


    図6.1.2.2-3

「サーバで実行時の設定」の、「ブラウザーを起動する」を指定することで、 アプリケーション開発時の機能である「サーバで実行」時のブラウザの起動を制御することができます。
表6.1.2.2-1
設定項目
 説明
 値
ブラウザーを起動する
 アプリケーション開発時の機能である「サーバで実行」時に、 ブラウザーを自動的に「起動する」、「起動しない」を指定します。
 選択：起動する(デフォルト)
非選択：起動しない

5.2. サーバで実行

ビルドしたアプリケーションを実行するには、アーカイブの作成、デプロイ、実行といった操作が必要で、 これらは、以下の機能、手段を用いて可能です。
表6.2-1
操作 機能・手段
アーカイブの作成 プロジェクトのエクスポート機能
デプロイ otxadmin、統合運用管理ツール
実行 ブラウザからの呼び出し など。

しかし、これら一連の操作は、Developer's Studio のサーバーで実行機能により、一括して実行することができます。

プロジェクトを選択し、右クリックメニュー の 実行 ＞ サーバーで実行 を選択します。


図6.2-1

初めてサーバーを選択する場合、手動で新規サーバーを定義 を選択して、 次へ をクリックします。
サーバーの設定を行っていない場合、WebOTXマニュアル WebOTXランタイムの設定 を参照の上、設定を行ってください。


図6.2-2

サーバーユーザー名、サーバーパスワードを入力し、ユーザードメインポート を確認して、 終了 をクリックします。

Memo
ドメインへの接続には、ユーザードメイン名ではなく、ユーザードメインポートが利用されます。 ユーザードメインポートには、正しいポート番号を指定してください。


図6.2-3

アプリケーションの配備状況は、サーバービューで確認できます。
サーバービューは、メニュー のウィンドウ ＞ ビューの表示 ＞ その他からサーバー ＞ サーバーを選択すると表示されます。

Memo
「サーバで実行」に失敗する場合、 [ サーバツール > 注意制限事項 > 制限事項 > 「サーバで実行」に失敗する (For input string: "m") ] をご覧ください。

5.2.1. WebOTXの設定

サーバーで実行機能を効果的に利用するための設定について説明します。
プロジェクトの右クリック・メニューのプロパティで起動するプロパティー画面で WebOTXの設定を選択します。


図6.2.1-1

5.2.1.1. ブラウザーを起動する
[サーバの設定の編集方法] の指定の、 プロジェクト毎への設定です。起動の指定に加えて、URL の指定が可能です。
表6.2.1-1
設定項目
 説明
 値
ブラウザーを起動する
 アプリケーション開発時の機能である「サーバで実行」時に、 ブラウザーを自動的に「起動する」、「起動しない」を指定します。 選択：起動する
非選択：起動しない
URL
 起動するURLを指定します。 また、[参照]ボタンを利用して、コンテキスト・ルートや、プロジェクトに含まれる、 サーブレット、JSP/HTML を設定することもできます。 コンテキスト・ルート
サーブレット
JSP/HTML
コマンドの設定
 「サーバで実行」時に実行される 配備、配備解除コマンド のオプションを編集できます。
※配備、配備解除コマンドとは、ESBのSAプロジェクトの場合は deploy-jbi-service-assembly、 undeploy-jbi-service-assemblyです。 それ以外のプロジェクトの場合は deploy、undeployです。
5.2.1.2. コマンドの設定
WebOTXの設定のコマンドの設定で、 カスタマイズ対象のコマンドを選択し、編集ボタンをクリックします。 オプションをカスタマイズする を選択すると、表示されたオプションを編集可能になります。


図6.2.1-2

表6.2.1-2
既定パラメーター
 説明
$username
 サーバー設定で設定されるサーバーユーザー名です。
$password
 サーバー設定で設定されるサーバーパスワードです。
$apgname
 サーバー設定で設定されるアプリケーショングループ名です。
$pgname
 サーバー設定で設定されるプロセスグループ名です。
$host
 サーバー設定で設定されるホスト名です。
$port
 サーバー設定で設定されるユーザードメインポートです。
$protocol
 サーバー設定で設定されるリモートサーバー接続用プロトコルです。
$location
 カレントプロジェクトのアーカイブの格納先。
$option
 サーバー接続用オプションです。
カスタマイズ時のオプション指定の誤りにより、コマンド実行時にエラーが発生する場合、 [ 運用管理コマンドリファレンス] をご覧の上、誤りを修正してください。

Memo
この機能はプロジェクト単位の設定として管理されます。プロジェクトを共用した場合、 そのカスタマイズ内容も共用されるので、共用を意図しない一時的なカスタマイズを行う際にはご注意ください。

5.2.2. 管理者権限が無い場合のサーバで実行

5.2.2.1. 運用管理コマンド(otxadmin)でドメインを起動
管理者権限が無い場合、運用管理コマンドで、サーバの起動方法を説明します。
  1. 運用管理コマンド(otxadmin)を起動します。
  2. ドメインを起動します。 
    otxadmin> start-domain --user admin --password adminadmin --host localhost --port 6202 --remote=true domain1
5.2.2.2. Developer's Studioで管理ドメインを使用し、サーバで実行
管理者権限が無い場合、Developer's Studioで管理ドメインを使用し、サーバの起動方法を説明します。
  1. 先ず、新規サーバを作成、設定します。新規サーバの作成は[サーバで実行]を参照してください。その設定は下図を参照してください。


    図6.2.2.2-1

  2. サーバを作成した後に、ウークスペースで選択したプロジェクトをサーバで実行します。
  3. ドメインが起動され、選択されたプロジェクトが成功に配備されます。

5.2.3. 管理者権限が無い場合のサーバでデバッグ

5.2.3.1. 運用管理コマンド(otxadmin)でデバッグ
管理者権限が無い場合、運用管理コマンドで、サーバの起動方法を説明します。
  1. 運用管理コマンド(otxadmin)を起動します。
  2. ドメインを起動します。 
    otxadmin> start-domain --user admin --password adminadmin --host localhost --port 6202 --remote=true domain1
  3. ドメインにログインします。 
    otxadmin> login --user admin --password adminadmin --host localhost --port 6212
  4. debugモードに設定します。 
    otxadmin> set server.java-config.debug-enabled=true
  5. ドメインに停止します。 
    otxadmin> stop-domain domain1
  6. ドメインを再起動します。 
    otxadmin> start-domain --user admin --password adminadmin --host localhost --port 6202 --remote=true domain1
5.2.3.2. Developer's Studioで管理ドメインを使用し、サーバでバッグ
管理者権限が無い場合、Developer's Studioでサーバをデバッグで起動します。
  1. [サーバの設定の編集方法]を参照して、開いたサーバの編集画面で、ドメインと管理ドメインを設定します。


    図6.2.3.2-1

  2. 設定した後に、右クリックして、デバッグを選択します。


    図6.2.3.2-2

  3. デバッグ をクリックし、ドメインを起動します。

5.3. バージョン管理

以下の方法で、デプロイするモジュールにバージョンを指定することができます。

5.3.1. バージョン更新後の旧バージョンのデプロイ解除について

プロジェクトのバージョン更新後にデプロイを行うと、新バージョンがデプロイされ、enabled 状態になります。 その際、旧バージョンはデプロイ解除は行われず、disabled 状態になります。 旧バージョンをデプロイ解除する場合は、統合運用管理ツールプラグイン、もしくは otxadmin をご利用ください。

5.4. サーバー定義とデプロイしたモジュールの関係

5.4.1. デプロイ状況の表示

Developer's Studio での 「サーバー定義」、「プロジェクト」と、サーバーにデプロイされる「モジュール」 の関係について説明します。

プロジェクト１～３ で生成したモジュール１～３ を、サーバー上のドメイン１に対して定義した、 サーバー定義１、２ にデプロイしたとします。なお、図中のモジュール４は、Developer's Studio 以外の手段 (統合運用管理ツールプラグインや otxadmin) でデプロイしたとします。


図6.4.1-1

Developer's Studio でのサーバー定義毎の表示は、"Developer's Studio でのデプロイ状況" を示すもので、 その時点での "実サーバー上でのデプロイ状況" を示しているとは限りません。先の例の場合、以下の点にご注意ください。

5.4.2. サーバー定義の活用方法

同一サーバー定義配下のプロジェクトは、 の際に、サーバーに再デプロイされます。 そのため、同一サーバー定義配下に、 をデプロイしていると、"再デプロイに長い時間がかかる"、"必要がないプロジェクトまでデプロイされてしまう" といった問題が発生します。
このような問題は、関連するプロジェクトのグループ毎にサーバー定義を行う事で回避できます。 また、関連するプロジェクトのデプロイ漏れを防ぐ効果も期待できます。

5.5. 統合運用管理ツールプラグインの使用方法

Developer's Studio 内で、統合運用管理ツールを利用することができます。
以下に、その起動方法について説明します。
詳細な使用方法については、 [ 操作方法 > 統合運用管理ツール(WebOTX Administrator) ] をご覧下さい。
  1. メニューの ウィンドウ ＞ パースペクティブを開く ＞ その他 を選択します。


    図6.5-1

  2. WebOTX運用管理ツール を選択します。


    図6.5-2

  3. 「接続」ダイアログが表示されますので、以降の手順については、 [ 操作方法 > 統合運用管理ツール(WebOTX Administrator) > ドメインとの接続と切断 > ドメインとの接続 ] をご覧ください。


    図6.5-3

5.6. 注意制限事項

5.6.1. 注意事項

5.6.1.1. サポートする動的Webモジュール(Dynamic Web Module)のバージョンについて
サポートする動的Webモジュール(Dynamic Web Module)のバージョンは2.4、2.5、3.0、3.1 です。
5.6.1.2. デプロイしていたモジュールが disabled 状態に変更されてしまう
プロジェクトのバージョンを更新した場合、[サーバー定義の活用方法] に記載した、 による再デプロイで、新モジュールが enabled 状態になったことで、元のバージョンが disabled になった可能性があります。 そのような場合、otxadmin で、 
　enable アプリケーション名
により、enabled 状態を再設定できます。
5.6.1.3. サーバーパスワードとオプション、管理ドメインパスワードと管理ドメインオプションの関係
  1. パスワード値が空白、且つ、オプションにpasswordfile オプションが含める場合、サーバーが起動可能です。以下の図を参照してください。


    図6.6.1.3-1

  2. パスワード値があり、且つ、オプションにpasswordfile オプションを含めない場合、サーバーが起動可能です。以下の図を参照してください。


    図6.6.1.3-2

  3. パスワード値があり、且つ、オプションにpasswordfile オプションを含める場合、サーバーが起動可能です。パスワード値が優先に利用されます。以下の図を参照してください。


    図6.6.1.3-3

  4. パスワード値が空白、且つ、オプションにpasswordfile オプションを含めない場合、サーバーが起動できません。
管理ドメインパスワードと管理ドメインオプションの関係は、サーバーパスワードとオプションの関係と同じです。

5.6.2. 制限事項

5.6.2.1. 「サーバで実行」に失敗する (For input string: "m")
「サーバで実行」時に、以下の現象により、実行に失敗する場合があります。 
 公開を開始します。少々お待ちください．．．
 ProjectNameの公開中．．．
 エラーが発生しました。公開を中止します。
 エラー：For input string: "m"
この現象は、V8.4 より前の Developer's Studio で作成したワークスペースを利用した場合に発生します。
回避策として、以下を実施してください。
  1. サーバビューを開く。(サーバの設定の編集方法の、2. までの手順をご覧ください。)
  2. サーバビューに表示された、V8.4より前に作成されたサーバを削除。
  3. サーバを新規作成する。( [ 環境設定 > テスト用サーバの設定 > WebOTXサーバーの新規作成 ] をご覧ください。)
Copyright (C) 1998 - 2020 NEC Corporation. All rights reserved.