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

2.7 ismodifyservice

名前

　ismodifyservice　−　Interstage運用環境へのサービスの追加／変更／削除

形式

1. サービスの追加
   　ismodifyservice [-M システム名] -a | -d ES|SOAPCLGW|FJapache
2. ネーミングサービス、インタフェースリポジトリ（標準インタフェース／valueインタフェース）の参照先をローカルホストに変更
   　ismodifyservice [-M システム名] -a NS|IR
3. ネーミングサービス、インタフェースリポジトリ（標準インタフェース）の参照先をリモートホストに変更
   　ismodifyservice [-M システム名] -r -h ホスト名 [-p ポート番号] NS|IR

機能説明

　ismodifyserviceコマンドは、指定されたサービスに対して、以下の操作を行うコマンドです。

• サービスの追加
• ネーミングサービス、インタフェースリポジトリ（標準インタフェース／valueインタフェース）の参照先変更
• サービスの削除

　本コマンドにより操作できるサービスは以下のものです。

• インタフェースリポジトリ(標準インタフェース)
• インタフェースリポジトリ(valueインタフェース)
• ネーミングサービス
• イベントサービス
• CORBA/SOAPクライアントゲートウェイ
• Interstage HTTP Server（Enterprise Editionのみ）

　本機能を使用してサービスを追加した場合、そのサービスのチューニング値は、セットアップされているシステム規模に従ってカストマイズされます。

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

-M システム名

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

-a

　サービスの追加を行う場合に指定します。
　また、ネーミングサービス、インタフェースリポジトリ（標準インタフェース／valueインタフェース）の参照先をローカルホストに変更する場合にも指定します。

-r

　ネーミングサービス、インタフェースリポジトリ（標準インタフェース）の参照先をリモートホストに変更する場合に指定します。

-d

　サービスの削除を行う場合に指定します。

-h ホスト名

　-rオプション指定時に変更するホスト名を指定します。

-p ポート番号

　-rオプション指定時に変更するポート番号を指定します。省略した場合は8002が指定されたものとみなします。

サービス識別名

　追加／変更／削除するサービスの識別名を指定します。
　各サービスの識別名は、以下のとおりです。大文字／小文字の区別はありません。

サービス	指定する識別名
インタフェースリポジトリ（標準インタフェース）	IR
ネーミングサービス	NS
イベントサービス	ES
Interstage HTTP Server （Enterprise Editionのみ）	FJapache
CORBA/SOAPクライアントゲートウェイ	SOAPCLGW

注意事項

• 本コマンドは、管理者権限だけが実行可能です。
• ismodifyserviceコマンドを使用してInterstage運用環境へのサービスの追加／変更／削除を行う場合、本操作の完了後、下記のサービスを再起動してください。再起動操作を行わなかった場合、以降のInterstage管理コンソールによる操作でエラーが発生することがあります。

  

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

  

  • Interstage管理コンソール用Servletサービス

  上記サービスの再起動時にIJServerが起動している場合、そのIJServerのモニタ参照およびHotDeploy機能の使用ができなくなります。上記操作と共にIJServerの再起動を行ってください。
  詳細は“トラブルシューティング集”の“Interstage管理コンソールの統計情報の異常”を参照してください。

• 本コマンドを多重に実行することはできません。
• 以下のサービスがセットアップ済みの環境に対して、本コマンドは使用できません。
  • ロードバランスオプション
  • データベース連携サービス
• 以下の場合は本コマンドを実行することはできません。
  • Interstageの各サービスが動作中の場合
  • isgendefコマンド、isregistdefコマンド、isstartコマンド、isstopコマンドまたはisstatコマンドが実行中の場合
• 本コマンドを使用する場合、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)
• 追加／削除しようとするサービスの依存するサービスが存在しない場合、本コマンドは実行できません。
• 本コマンドはInterstageの初期化が完了している状態でなければ実行することができません。
• ネーミングサービス／インタフェースリポジトリのどちらか一方、または両方がリモート参照になる場合、運用形態はTYPE3に変更されます。
• ネーミングサービス／インタフェースリポジトリがともにローカル参照になる場合、運用形態はTYPE1に変更されます。
• インタフェースリポジトリをローカルにセットアップし、かつネーミングサービスがローカル参照になっている場合、インタフェースリポジトリ（valueインタフェース）が自動的にセットアップされます。
• インタフェースリポジトリの参照先をリモートホストに変更する場合、インタフェースリポジトリ（valueインタフェース）は、アンセットアップされます。
• イベントサービスを使用する場合に、esmkchnlコマンドによりイベントチャネルを作成後、ismodifyserviceコマンドでネーミングサービスの操作を行う際は、ismodifyserviceコマンド実行前にesrmchnlコマンドにより、作成済みのイベントチャネルを削除してください
  esrmchnlコマンドの詳細については、“esrmchnl”を参照してください。
• Interstage HTTP Serverを拡張システムに対して追加／削除することはできません。（Enterprise Editionのみ）

使用例

イベントサービスを追加する場合

　ismodifyservice -a ES

ネーミングサービスの参照先を変更する場合

　ismodifyservice -r -h host01 NS