Interstage Application Server リファレンスマニュアル（コマンド編）

2.4 isinit

名前

　isinit　−　Interstageの初期化

形式

　isinit [-M システム名] [-f] [-w] TYPE1 | TYPE2 | TYPE3 | type1 | type2 | type3　［ EJB | ejb ］
　isinit [-M システム名] -l

機能説明

　isinitコマンドは、引数に指定された運用形態とInterstage動作環境定義で指定したサービスを初期化します。isinitコマンドで初期化できるサービスには、以下があります。

• CORBAサービス
• ネーミングサービス
• インタフェースリポジトリ（標準インタフェース）
• インタフェースリポジトリ（valueインタフェース）
• イベントサービス
• コンポーネントトランザクションサービス
• データベース連携サービス
• ロードバランスオプション
• Interstage HTTP Server （Enterprise Editionのみ）
• CORBA/SOAPクライアントゲートウェイ

　Interstage統合コマンドによるInterstage起動およびマシンブート時のInterstage自動起動を行うには、本コマンドによってあらかじめInterstageを構成するサービスの初期化を行う必要があります。

　各サービスの初期化時のパラメタはInterstage動作環境定義から読み込みます。この時、初期化するサービスで必要となる定義項目が正しく設定されている必要があります。
　Interstage動作環境定義をカストマイズすることによって以下の設定ができます。

• インタフェースリポジトリで使用するデータベースの種類、および格納先のパス、サイズの設定。

• インタフェースリポジトリで使用するデータベースの種類、および格納先のパス、サイズ、ユーザ名、グループ名の設定。

• ネーミングサービス/インタフェースリポジトリの登録ホスト名、およびポート番号。
• コンポーネントトランザクションサービスの動作環境を作成するディレクトリの設定。
• データベース連携サービスの多重度、およびシステムログファイルのパス、トランザクション最大数の設定。

　Interstage動作環境定義の記述形式については、“Interstage Application Server 運用ガイド”を参照してください。
　また、初期導入を除く契機でisinitコマンドを実行する場合、以下の条件と一致するサービスの登録資源が削除される場合があります。事前に、Interstageの全資源のバックアップを行うことを推奨します。バックアップの詳細については、“Interstage Application Server 運用ガイド”を参照してください。下記以外の資源については、-fオプションを指定した場合を除き、引き継がれます。

• セットアップの対象より外したサービスの資源
• Interstage動作環境定義の定義項目を変更したサービス（ただし、CORBAサービス、ネーミングサービス、インタフェースリポジトリ、イベントサービス、ロードバランスオプションのいずれかの定義項目を変更した場合には、これら5つのサービスの登録済み情報とワークユニット定義が削除されます）
• CORBAサービスを運用するホスト名（Interstageの全資源が初期化されます）

　下記の資源については、-fオプション指定の有無にかかわらず初期化は行われません。

• インプリメンテーションリポジトリ(impl.db)

　インプリメンテーションリポジトリ(impl.db)を初期化する場合は、以下の手順でisinitコマンドを実行してください。

1. Interstageを全強制停止します。
2. 以下のファイルを上書きコピーします（インストールディレクトリはデフォルト）。
   　
   　　コピー元ファイル：C:\Interstage\ODWIN\impl.db.default
   　　コピー先ファイル：C:\Interstage\ODWIN\impl.db
   　
   　　コピー元ファイル：/etc/opt/FSUNod/impl.db.default
   　　コピー先ファイル：/etc/opt/FSUNod/impl.db
   　
   　　コピー元ファイル：/etc/opt/FJSVod/impl.db.default
   　　コピー先ファイル：/etc/opt/FJSVod/impl.db
3. -fオプションを指定して、isinitコマンドを実行します。
   このとき、以下のエラーメッセージが出力される場合がありますが、問題ありません。
   　od15005, od15009

　以下に、isinitコマンドのオプションおよび引数を説明します。

-M システム名

　対象のシステム名を指定します。
　本オプションを省略すると、デフォルトシステムが対象となります。

-l

　現在の運用形態を表示します。
　以前にisinitコマンドによってInterstageの初期化処理が完了している場合にのみ有効なオプションです。本オプションが指定された場合はInterstageの初期化処理は行いません。

-f

　強制初期化モードです。
　運用形態とInterstage動作環境定義で指定されたすべてのサービスについて、登録済み情報を初期化します。これにより、初期化前に登録されていたデータ（登録済みのワークユニット定義情報やオブジェクトリファレンスなど）は、すべて削除されます。

-w

　Interstageのクラスタサービス機能を使用する場合にのみ有効なオプションです。
　待機系ノードの初期化を行う場合に指定します。
　運用形態にtype2を指定する場合には、データベース連携サービスのシステムログファイルが、Interstage動作環境定義の“OTS path for system log”で指定するディレクトリ配下に、存在する必要があります。

TYPE1またはtype1

　CORBAサービス、ネーミングサービス、インタフェースリポジトリ、コンポーネントトランザクションサービスから構成される運用形態です。

TYPE2またはtype2

　CORBAサービス、ネーミングサービス、インタフェースリポジトリ、コンポーネントトランザクションサービス、データベース連携サービスから構成される運用形態です。

TYPE3またはtype3

　CORBAサービス、コンポーネントトランザクションサービスから構成される運用形態です。

EJBまたはejb

　EJBサービスを使用する場合に指定します。
　運用形態がTYPE3(type3)の場合は、ローカルホストのインタフェースリポジトリを使用する場合のみ指定できます。Interstage動作環境定義に、インタフェースリポジトリをローカルホストで使用する様に登録してください。

注意事項

• 本コマンドは、管理者権限だけが実行可能です。
• isinitコマンドを使用してInterstageの初期化を行う場合、Interstageの初期化完了後、Interstageが停止状態のまま下記のサービスを再起動してください。再起動操作を行わなかった場合、以降のInterstage管理コンソールによる操作でエラーが発生することがあります。

  

  • Interstage Operation Toolサービス
  • Interstage JServlet(OperationManagement)サービス

  

  • Interstage管理コンソール用Servletサービス
• 本コマンドを多重に実行することはできません。
• 以下の場合は本コマンドを実行することはできません。
  • Interstageの各サービスが動作中の場合
  • isgendef、isregistdef、isstart、isstopまたはisstatコマンドが実行中の場合
• 本コマンドを実行する場合、inithostファイルに指定されているインタフェースリポジトリサービスおよびネーミングサービスのホスト名をコメントまたは削除してください。なお、inithostファイルで他のホストを設定する場合は、本コマンドの実行後に設定してください。
• すでに作成済みのIJServerでSSLを使用している場合には、本コマンドの発行前に、SSLを使用しているJServerに対し、以下のいずれかの対処を実施してください。なお、isj2eeadminコマンドを使用して、操作することもできます。
  • Interstage管理コンソールの［システム］>［ワークユニット］>［IJServer名］の[環境設定]タブで、SSLを使用しないように設定してください。
  • Interstage管理コンソールの[システム]>[ワークユニット]の[状態]タブで、IJServerを削除する。
• トランザクションサービス（OTS）を使用する場合、基本的に、Interstage管理コンソールとInterstage統合コマンドの併用は、行わないでください。
  これらの機能を併用する場合には、以下の点に注意してください。
  - Interstage管理コンソールを使用してOTSを使用する設定を行った環境に対し、Interstage統合コマンドを使用した初期化操作を行う場合には、事前に、Interstage管理コンソールを使用し、OTSを使用しない設定に変更してから実行してください。
  - Interstage統合コマンドを使用し、運用形態TYPE2で初期化を行った環境に対し、Interstage管理コンソールを使用したチューニングを行う場合には、事前に、Interstage統合コマンドを使用し、運用形態TYPE1でセットアップしてから実行してください。
• 本コマンドによりネーミングサービスの初期化を行った場合、ネーミングサービスは、ネーミングサービスの拡張機能を使用する設定となります。V2.1以前のInterstageで作成したアプリケーションを運用する場合、ネーミングサービスの拡張機能を使用しない設定とする必要がありますので、その場合、nsconfigファイルをカストマイズし、ネーミングサービスの拡張機能を使用しない設定としてください。nsconfigファイルに関する詳細は、“チューニングガイド”を参照してください。
• 本コマンドを使用する場合、Interstage統合コマンドにより初期化済みのサービスに対して、以下のコマンドを発行してはいけません。ただし、下記(*)のコマンドに関しては、Interstage動作環境定義の稼働状態監視モード（定義項目“IS Monitor Mode”にて指定）に“mode2”を指定して初期化している場合、発行することができます。
  • otssetup
  • otsmklog
  • tdsetup
  • tdunsetup
  • tdstart
  • tdstop
  • otsstart
  • otsstop
  • essetup
  • esunsetup
  • esstart
  • esstop
  • odsetlbo
  • odstartlbo
  • odstoplbo
  • soapgwstartclgw (*)
  • soapgwstopclgw (*)

  

  • odadmin_ex

  

  • odadmin
  • S99startod
  • CosNaming_s
  • InterfaceRep_Cache_s
  • InterfaceRep_Cache_e
  • OD_stop
  • apachectl
• 
  本コマンドを使用する場合には、コントロールパネルのサービスや、net start / net stopコマンドを使用して、以下のサービスの起動・停止についても実施しないでください。ただし、下記(*)のサービスに関しては、Interstage動作環境定義の稼働状態監視モード（定義項目“IS Monitor Mode”にて指定）に“mode2”を指定して初期化している場合、操作することができます。
  • CORBAサービス(OD_start)
  • ネーミングサービス(Naming Service)
  • インタフェースリポジトリ(InterfaceRep_Cache Service)
  • インタフェースリポジトリ(InterfaceRep_Cache_e Service)
  • イベントサービス(EventService)
  • コンポーネントトランザクションサービス(TransactionDirector)
  • データベース連携サービス(ObjectTransactionService)
  • Interstage APIサービス(INTERSTAGE API)
  • Interstage HTTP Server (*)
  • CORBA/SOAPクライアントゲートウェイ(CORBA_SOAP ClientGW) (*)
  • ロードバランスオプション(NS LoadBalancingOption)
• イベントサービスを使用する場合に、esmkchnlコマンドによりイベントチャネルを作成後、Interstageの初期化を行う際は、初期化前にesrmchnlコマンドにより、作成済みのイベントチャネルを削除してください。esrmchnlコマンドの詳細については、“esrmchnl”を参照してください。
• 
  本コマンド実行時、インタフェースリポジトリのユーザ名、インタフェースリポジトリのグループ名を以下のように設定しています。
  　ユーザ名：root
  　グループ名：sys
  本コマンドによりインタフェースリポジトリの環境設定を行う場合は、"root"ユーザが"sys"グループに登録されている必要があります。この登録がない場合、以下のメッセージを出力してInterstageの初期化が失敗します。"root"ユーザが"sys"グループに登録されていることを確認してください。
  • "root"ユーザが存在しない場合。
    　Invalid settings in the environment setting file.
    　Invalid user-name is specified.
    　環境設定ファイルの内容に誤りがあります。
    　間違ったユーザ名が設定されました。
  • "root"ユーザが"sys"グループに登録されていない場合。
    　Invalid settings in the environment setting file.
    　Invalid group-name is specified.
    　環境設定ファイルの内容に誤りがあります。
    　間違ったグループ名が設定されました。