Interstage Application Server 高信頼性システム運用ガイド

A.3.4 EJBサービスでのロードバランスの運用手順

　EJBサービスでロードバランス機能を利用する手順を、使用する機能ごとに説明します。
　EJBサービスでロードバランス機能を利用する場合、ロードバランス対象のオブジェクトの登録は、固定登録で行ってください。
　各コマンドの詳細は、“リファレンスマニュアル(コマンド編)”を参照してください。

• 高速呼び出し機能を使用する場合
  • Interstageの環境設定
  • EJBアプリケーションの配備
  • EJBアプリケーションの起動

  上記の手順で運用を行うことができます。以下の作業は必要に応じて実施してください。

  • EJBアプリケーションの停止
  • EJBアプリケーションの上書き配備
  • EJBアプリケーションの配備解除
• Light EJBコンテナ機能を使用する場合
  • Interstageの環境設定
  • Light EJBコンテナの作成
  • EJBアプリケーションの配備
  • Light EJBコンテナの起動

  上記の手順で運用を行うことができます。以下の作業は必要に応じて実施してください。

  • Light EJBコンテナの停止
  • EJBアプリケーションの上書き配備
  • EJBアプリケーションの配備解除
  • Light EJBコンテナの削除

■高速呼び出し機能を使用する場合

◆Interstageの環境設定

　ロードバランスを運用するロードバランス管理サーバにおいて、以下の作業を行います。

1.ロードバランス管理サーバでの作業

(1) Interstage動作環境定義の変更

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　Interstageのインストールフォルダ\td\etc\isreg\isinitdef.txt

［設定する内容］
　　LBO USE = yes

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　TD_HOME/etc/isreg/isinitdef.txt
　　TD_HOME:コンポーネントトランザクションサービスのインストールディレクトリ

［設定する内容］
　　LBO USE = yes

(2)Interstage動作環境の設定

　Interstageの初期化（isinit）で指定する運用形態には、TYPE1またはTYPE2を選択し、必ずEJBオプションを指定してください。

＞isinit TYPE1 EJB

(3)Interstageの起動

　isstartコマンドを使用して、Interstageを起動します。

＞isstart

2.業務サーバの環境設定

　ロードバランス対象のEJBアプリケーションが動作するすべての業務サーバ上で、以下の作業を行います。

(1)Interstage動作環境定義の変更

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　Interstageのインストールフォルダ\td\etc\isreg\isinitdef.txt

［設定する内容］
　　NS USE = remote
　　NS Host Name = [ロードバランス管理サーバのホスト名]
　　NS Port Number = [ロードバランス管理サーバのポート番号]
　　IR USE = local

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　TD_HOME/etc/isreg/isinitdef.txt
　　TD_HOME:コンポーネントトランザクションサービスのインストールディレクトリ

［設定する内容］
　　NS USE = remote
　　NS Host Name = [ロードバランス管理サーバのホスト名]
　　NS Port Number = [ロードバランス管理サーバのポート番号]
　　IR USE = local

(2)Interstage動作環境の設定

　Interstageの初期化（isinit）で指定する運用形態には、TYPE3を選択し、EJBオプションを指定してください。

(3)ロードバランスの設定

　odsetlboコマンドまたはisinitコマンドを使用して、ロードバランスの設定を行います。
　以下にodsetlboコマンドを使用する場合の例を示します。

＞odsetlbo -r -h [ロードバランス管理サーバのホスト名] -p [ロードバランス管理サーバのポート番号]

◆EJBアプリケーションの配備

1.業務サーバ/ロードバランス管理サーバのEJBアプリケーション配備

　ロードバランスを運用するロードバランス管理サーバ/業務サーバにおいて、以下の作業を行います。

(1)EJBアプリケーションの配備

　ejbinstallebコマンドにより、ロードバランス対象のEJBアプリケーションを配備します。このとき、必ず-Nオプションを指定してください。

＞ejbinstalleb -N [インストール元ディレクトリ名]

(2)インプリメンテーションリポジトリIDとインタフェースリポジトリIDの確認

　ejbinfoapfolderコマンドを使用して、ロードバランス対象のEJBアプリケーションのインプリメンテーションリポジトリIDとインタフェースリポジトリIDを表示します。

＞ejbinfoapfolder EJBアプリケーション名

2.ロードバランス管理サーバのロードバランスオブジェクトグループの登録

(1)ロードバランスオブジェクトグループの登録

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを登録します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。このときに-g lbオプションを指定してください。

＞OD_or_adm -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -g lb -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

3.業務サーバのロードバランスオブジェクトグループへの登録

(1)ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループへ登録

　odadministerlbコマンドを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループへ登録します。バランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。
　ロードバランスオブジェクトグループへの登録は、“-h”で指定する業務サーバのホスト数分行ってください。

＞odadministerlb -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID ] -h [業務サーバのホスト名] -p [業務サーバのポート番号] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

◆EJBアプリケーションの起動

1.ロードバランス管理サーバのEJBアプリケーションの起動

(1)ロードバランスオブジェクトグループの起動

　isstartwuコマンドにより、ロードバランスオブジェクトグループであるEJBアプリケーションが登録されているワークユニットを起動します。

＞isstartwu [ワークユニット名]

2.業務サーバのEJBアプリケーションの起動

(1)EJBアプリケーションの起動

　isstartwuコマンドにより、ロードバランス対象のEJBアプリケーションが登録されているワークユニットを起動し、クライアントから運用を開始します。

＞isstartwu [ワークユニット名]

◆EJBアプリケーションの停止

1.ロードバランス管理サーバのEJBアプリケーションの停止

(1)EJBアプリケーションの停止

　isstopwuコマンドにより、ロードバランスオブジェクトグループであるEJBアプリケーションが登録されているワークユニットを停止します。

＞isstopwu [ワークユニット名]

2.業務サーバでの作業

(1)EJBアプリケーションの停止

　isstopwuコマンドにより、ロードバランス対象のEJBアプリケーションが登録されているワークユニットを停止します。

＞isstopwu [ワークユニット名]

◆EJBアプリケーションの上書き配備

1.ロードバランス管理サーバのEJBアプリケーションの上書き配備

(1)ロードバランスオブジェクトグループの解除

　odadminsterlbを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループから削除します。管理サーバと業務サーバのホスト分行ってください。

>odadministerlb -d -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -h [管理サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

>odadministerlb -d -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -h [業務サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

(2) オブジェクトリファレンスの解除

OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを削除します。

>OD_or_adm -d -n EJBアプリケーション名

2.ロードバランス管理サーバ、業務サーバのEJBアプリケーションの配備

(1) EJBアプリケーションの上書き配備

　ejbinstallebコマンドにより、ロードバランス対象のEJBアプリケーションを配備します。このとき、必ず-Nオプションを指定してください。

　　ejbinstalleb コマンド -N インストール元ディレクトリ名

3.ロードバランス管理サーバのロードバランスオブジェクトグループの登録

(1) ロードバランスオブジェクトグループの登録

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを登録します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。このときに-g lbオプションを指定してください。

＞OD_or_adm -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -g lb -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

(2)ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループへ登録

　odadministerlbコマンドを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループへ登録します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。
　ロードバランスオブジェクトグループへの登録は、“-h”で指定する業務サーバのホスト分行ってください。

＞odadministerlb -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID ] -h [業務サーバのホスト名] -p [業務サーバのポート番号] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

◆EJBアプリケーションの配備解除

1.ロードバランス管理サーバのロードバランスオブジェクトグループの解除

(1)ロードバランスオブジェクトグループの解除

　odadminsterlbを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループから削除します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。管理サーバと業務サーバのホスト分行ってください。

>odadministerlb -d -c [インタフェースリポジトリID -a インプリメンテーションリポジトリID] -h [管理サーバのホスト名 -n EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

>odadministerlb -d -c [インタフェースリポジトリID -a インプリメンテーションリポジトリID] -h [業務サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

(2) オブジェクトリファレンスの解除

OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを削除します。

>OD_or_adm -d -n EJBアプリケーション名

2.ロードバランス管理サーバ、業務サーバでのオブジェクトグループからの削除

(1)EJBアプリケーションの配備解除

　ejbuninstallebコマンドにより、ロードバランス対象のEJBアプリケーションを配備解除します。

ejbuninstalleb コマンド EJBアプリケーション名

ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループからの削除をしないで、以下の操作を行った場合は、「EJB9999: システムエラーが発生しました」が発生します。

• ejbinstallebコマンドでの上書きインストール
• ejbuninstallebコマンドによるアンインストール

　システムエラーが発生した場合は、-eの強制オプションを使用して再度実施してください。強制オプションを使用してもシステムエラーのメッセージは出力されますが、処理は続行される

ため、エラーメッセージは無視してください。

■Light EJBコンテナ機能を使用する場合

◆Interstageの環境設定

　ロードバランスを運用するロードバランス管理サーバにおいて、以下の作業を行います。

1.ロードバランス管理サーバの環境設定

(1)Interstage動作環境定義の変更

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　Interstageのインストールフォルダ\td\etc\isreg\isinitdef.txt

［設定する内容］
　　LBO USE = yes

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。

　　TD_HOME/etc/isreg/isinitdef.txt

　　TD_HOME:コンポーネントトランザクションサービスのインストールディレクトリ

［設定する内容］
　　LBO USE = yes

(2)Interstage動作環境の設定

　Interstageの初期化（isinit）で指定する運用形態には、TYPE1またはTYPE2を選択し、必ずEJBオプションを指定してください。

＞isinit TYPE1 EJB

(3)Interstageの起動

isstartコマンドを使用して、Interstageを起動します。

＞isstart

2.業務サーバの環境設定

　ロードバランス対象のEJBアプリケーションが動作するすべての業務サーバ上で、以下の作業を行います。

(1)Interstage動作環境定義の変更

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　Interstageのインストールフォルダ\td\etc\isreg\isinitdef.txt

［設定する内容］
　　NS USE = remote
　　NS Host Name = [ロードバランス管理サーバのホスト名]
　　NS Port Number = [ロードバランス管理サーバのポート番号]
　　IR USE = local

　以下のInterstage動作環境定義に、ロードバランス管理サーバのホスト名とポート番号を設定します。
　　TD_HOME/etc/isreg/isinitdef.txt
　　TD_HOME:コンポーネントトランザクションサービスのインストールディレクトリ

［設定する内容］
　　NS USE = remote
　　NS Host Name = [ロードバランス管理サーバのホスト名]
　　NS Port Number = [ロードバランス管理サーバのポート番号]
　　IR USE = local

(2)Interstage動作環境の設定

　Interstageの初期化（isinit）で指定する運用形態には、TYPE3を選択し、EJBオプションを指定してください。

(3)ロードバランスの設定

　odsetlboコマンドまたはisinitコマンドを使用して、ロードバランスの設定を行います。
　以下にodsetlboコマンドを使用する場合の例を示します。

＞odsetlbo -r -h [ロードバランス管理サーバのホスト名] -p [ロードバランス管理サーバのポート番号]

◆Light EJBコンテナの作成

1.業務サーバ、ロードバランス管理サーバのLight EJBコンテナ作成

[J2EE Deployment ツール、または、J2EE管理ツールを使う場合]

　J2EE Deploymentツール、または、EJB Deploymentツールを使用して、ロードバランス対象のLight EJBコンテナを作成します。

[ejbinstalleb コマンドを使用する場合]

　ejbmakecontainerコマンドを使用して、ロードバランス対象のLight EJBコンテナを作成します。

＞ejbmakecontainer [Light EJBコンテナ定義]

◆EJBアプリケーションの配備

1.業務サーバ、ロードバランス管理サーバのEJBアプリケーションの配備

　ロードバランスを運用するロードバランス管理サーバ、業務サーバにおいて、以下の作業を行います。

[J2EE Deployment ツール、または、J2EE管理ツールを使う場合]

(1)EJBアプリケーションの配備

　J2EE Deploymentツール、または、EJB Deploymentツールを使用して、ロードバランス対象のLight EJBコンテナにEJBアプリケーションを配備します。

(2)インプリメンテーションリポジトリIDとインタフェースリポジトリIDの確認

　ejbinfoapfolderコマンドを使用して、ロードバランス対象のEJBアプリケーションのインプリメンテーションリポジトリIDとインタフェースリポジトリIDを表示します。

＞ejbinfoapfolder EJBアプリケーション名

(3)ネーミングサービスからEJBアプリケーション名の削除

　OD_or_admコマンドを使用して、EJBアプリケーション名を削除します。

＞OD_or_adm -d -n [EJBアプリケーション名]

[ejbinstalleb コマンドを使用する場合]

(1)EJBアプリケーションの配備

　ejbinstallebコマンドにより、ロードバランス対象のEJBアプリケーションを配備します。このとき、必ず-Nオプションを指定してください。

＞ejbinstalleb -N -s Light EJBコンテナ名 インストール元ディレクトリ名

2.ロードバランス管理サーバのロードバランスオブジェクトグループの登録

(1)ロードバランスオブジェクトグループの登録

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを登録します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。このときに-g lbオプションを指定してください。

＞OD_or_adm -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -g lb -n [ロードバランスオブジェクトグループ名]

3.業務サーバのロードバランスオブジェクトグループへの登録

(1)ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループへ登録

　odadministerlbコマンドを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループへ登録します。バランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。
　ロードバランスオブジェクトグループへの登録は、“-h”で指定する業務サーバのホスト数分行ってください。

＞odadministerlb -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID ] -h [業務サーバのホスト名] -p [業務サーバのポート番号] -n [ロードバランスオブジェクトグループ名]

◆Light EJBコンテナの起動

1.ロードバランス管理サーバのLight EJBコンテナ起動

(1)LightEJBコンテナの起動

　isstartwuコマンドにより、Light EJBコンテナを起動します。

＞isstartwu [Light EJBコンテナ名]

2.業務サーバのLight EJBコンテナ起動

(1)Light EJBコンテナの起動

isstartwuコマンドにより、Light EJBコンテナを起動し、クライアントから運用を開始します。

＞isstartwu [Light EJBコンテナ名]

◆Light EJBコンテナの停止

1.ロードバランス管理サーバのLightEJBコンテナの停止

(1)Light EJBコンテナの停止

　isstopwuコマンドにより、Light EJBコンテナを停止します。

＞isstopwu [Light EJBコンテナ名]

2.業務サーバのLight EJBコンテナの停止

(1)Light EJBコンテナの停止

isstopwuコマンドにより、Light EJBコンテナを停止します。

＞isstopwu [Light EJBコンテナ名]

◆EJBアプリケーションの上書き配備

1.ロードバランス管理サーバのEJBアプリケーションのロードバランスグループの削除

(1)インプリメンテーションリポジトリIDとインタフェースリポジトリIDの確認

　ejbinfoapfolderコマンドを使用して、ロードバランス対象のEJBアプリケーションのインプリメンテーションリポジトリIDとインタフェースリポジトリIDを表示します。

＞ejbinfoapfolder EJBアプリケーション名

(2)ロードバランスオブジェクトグループの削除

　odadminsterlbを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループから削除します。バランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。管理サーバと業務サーバのホスト数分行ってください。

＞odadministerlb -d -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -h [管理サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

＞odadministerlb -d -c [インタフェースリポジトリID -a インプリメンテーションリポジトリID] -h [業務サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

(3) オブジェクトリファレンスの解除

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを削除します。

＞OD_or_adm -d -n EJBアプリケーション名

2.ロードバランス管理サーバ、業務サーバのEJBアプリケーションの上書き配備

[J2EE Deployment ツール、または、J2EE管理ツールを使う場合]

(1)EJBアプリケーションの上書き配備

　J2EE Deploymentツール、または、EJB Deploymentツールを使用して、ロードバランス対象のEJBアプリケーションを上書き配備します。

(2)ネーミングサービスからEJBアプリケーション名の削除

　OD_or_admコマンドを使用して、EJBアプリケーション名を削除します。

＞OD_or_adm -d -n [EJBアプリケーション名]

[ejbinstalleb コマンドを使用する場合]

(1)EJBアプリケーションの上書き配備

　ejbuninstallebコマンドを使用して、ロードバランス対象のEJBアプリケーションを上書き配備します。

＞ejbinstalleb -N -s [Light EJBコンテナ名] [インストール元ディレクトリ名]

3.ロードバランス管理サーバのロードバランスオブジェクトグループの登録

(1)ロードバランスオブジェクトグループの登録

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを登録します。ロードバランスオブジェクトグループ名には、ロードバランス対象のEJBアプリケーション名を指定してください。このときに-g lbオプションを指定してください。

＞OD_or_adm -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID] -g lb -n [ロードバランスオブジェクトグループ名]

(2)ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループへ登録

　odadministerlbコマンドを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループへ登録します。
　ロードバランスオブジェクトグループへの登録は、“-h”で指定する業務サーバのホスト分行ってください。

＞odadministerlb -c [インタフェースリポジトリID] -a [インプリメンテーションリポジトリID ] -h [業務サーバのホスト名] -p [業務サーバのポート番号] -n [ロードバランスオブジェクトグループ名]

◆EJBアプリケーションの配備解除

1.ロードバランス管理サーバのEJBアプリケーションの配備解除

(1)インプリメンテーションリポジトリIDとインタフェースリポジトリIDの確認

　ejbinfoapfolderコマンドを使用して、ロードバランス対象のEJBアプリケーションのインプリメンテーションリポジトリIDとインタフェースリポジトリIDを表示します。

＞ejbinfoapfolder EJBアプリケーション名

(2)ロードバランスオブジェクトグループの解除

　odadminsterlbを使用して、ロードバランス対象のEJBアプリケーションを、ロードバランスオブジェクトグループから削除します。管理サーバと業務サーバのホスト分行ってください。

＞odadministerlb -d -c [インタフェースリポジトリID -a インプリメンテーションリポジトリID] -h [管理サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

＞odadministerlb -d -c [インタフェースリポジトリID -a インプリメンテーションリポジトリID] -h [業務サーバのホスト名] -n [EJBアプリケーション名(ロードバランスオブジェクトグループ名)]

(3) オブジェクトリファレンスの解除

　OD_or_admコマンドを使用して、ロードバランスオブジェクトグループを削除します。

＞OD_or_adm -d -n EJBアプリケーション名

2.ロードバランス管理サーバ、業務サーバのEJBアプリケーションの配備解除

[J2EE Deployment ツール、または、J2EE管理ツールを使う場合]

(1) EJBアプリケーションの配備解除

　J2EE DeploymentツールまたはEJB Deploymentツールを使用して、ロードバランス対象のEJBアプリケーションを配備解除します。

[ejbinstalleb コマンドを使用する場合]

(1)EJBアプリケーションの配備解除

　ejbuninstalleb コマンドを使用して、ロードバランス対象のEJBアプリケーションを配備解除します。

＞ejbuninstalleb -s [Light EJBコンテナ] [EJBアプリケーション名]

◆Light EJBコンテナの削除

1.業務サーバ、ロードバランス管理サーバのLight EJBコンテナの削除

(1)EJBアプリケーションの配備解除

Light EJBコンテナの削除前に、EJBアプリケーションの配備解除を実施してください。

(2)Light EJBコンテナの削除

[J2EE Deployment ツール、または、J2EE管理ツールを使う場合]

J2EE Deploymentツール、または、EJB Deploymentツールを使用して、ロードバランス対象のLight EJBコンテナを削除します。

[ejbinstalleb コマンドを使用する場合]

ejbdelcontainerコマンドを使用して、ロードバランス対象のLightE JBコンテナを作成します。

＞ejbdelcontainer [Light EJBコンテナ名]

　ロードバランス対象のEJBアプリケーションをロードバランスオブジェクトグループか

らの削除をしないで、上書き配備、または、配備解除を行った場合は、

以下のエラーが出力されます。

[J2EE Deployment ツール、または、J2EE管理ツール]

DEPLOY: エラー: DEP4511:CORBAサービスとの接続に失敗しました: Interstageを起動してください: Interstageが起動されている場合はシステムメモリが不足しています: 不要なサービスを停止するか、またはシステムを再起動してください

[EJB運用コマンド]

EJB0303: CORBAサービスとの接続に失敗しました