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

2.7 ismodifyservice

名前

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

形式

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

1. InfoProvider Proの追加
   　ismodifyservice [-M システム名] -a IPP Webサーバの識別子 環境定義ファイル名
2. InfoProvider Proの削除
   　ismodifyservice [-M システム名] -d IPP Webサーバの識別子

機能説明

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

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

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

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

• InfoProvider Pro

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

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

-M システム名

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

-a

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

-r

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

-d

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

-h ホスト名

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

-p ポート番号

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

サービス識別名

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

サービス	指定する識別名
インタフェースリポジトリ（標準インタフェース）	IR
ネーミングサービス	NS
イベントサービス	ES
Interstage HTTP Server （Enterprise EditionおよびStandard Editionのみ）	FJapache
InfoProvider Pro	IPP
V5.1以前のServletサービス	Servlet
CORBA/SOAPクライアントゲートウェイ	SOAPCLGW

Webサーバの識別子 環境定義ファイル名

　InfoProvider Proの追加時には、Webサーバの識別子および環境定義ファイル名を指定します。InfoProvider Proの削除時には、Webサーバの識別子のみ指定します。
　識別子は任意の8文字以内の英数字で指定してください。

　Webサーバの環境定義ファイル名はファイル名のみ指定します。

　Webサーバの環境定義ファイル名はフルパスで指定します。

注意事項

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

  

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

  

  • Interstage運用操作ツール
  • Interstage管理コンソール用Servletサービス

  上記サービスの再起動時にIJServerが起動している場合、そのIJServerのモニタ参照およびHotDeploy機能の使用ができなくなります。上記操作と共にIJServerの再起動を行ってください。

• 本コマンドを多重に実行することはできません。
• 以下のサービスがセットアップ済みの環境に対して、本コマンドは使用できません。

• ロードバランスオプション
• データベース連携サービス

• 以下の場合は本コマンドを実行することはできません。
  • Interstageの各サービスが動作中の場合
  • isgendefコマンド、isregistdefコマンド、isstartコマンド、isstopコマンドまたはisstatコマンドが実行中の場合
• 本コマンドを使用する場合、Interstage統合コマンドまたは運用操作ツールにより初期化済みのサービスに対して、以下のコマンドを発行してはいけません。ただし、下記(*)のコマンドに関しては、Interstage動作環境定義の稼働状態監視モード（定義項目“IS Monitor Mode”にて指定）に“mode2”を指定して初期化している場合、発行することができます。
  • otssetup
  • otsmklog
  • tdsetup
  • tdunsetup
  • tdstart
  • tdstop
  • otsstart
  • otsstop
  • essetup
  • esunsetup
  • esstart
  • esstop
  • ippstart (*)
  • ippstop (*)
  • ipprestart (*)
  • webgw_start (※1)
  • webgw_stop (※1)
  • odsetlbo
  • odstartlbo
  • odstoplbo
  • jssvstart (*)
  • jssvstop (*)
  • soapgwstartclgw (*)
  • soapgwstopclgw (*)

  

  • odadmin_ex
  • ippstartsv
  • ippstopsv
  • ippsetstartup

  

  • odadmin
  • S99startod
  • CosNaming_s
  • InterfaceRep_Cache_s
  • InterfaceRep_Cache_e
  • OD_stop
  • apachectl

  ※1)V6以降ではHTMLページ編集サービスを同梱していませんが、Windows(R)での上書きインストールの場合などは、HTMLページ編集サービスを使用できます。

• 追加／削除しようとするサービスの依存するサービスが存在しない場合、本コマンドは実行できません。
• 本コマンドはInterstageの初期化が完了している状態でなければ実行することができません。
• ネーミングサービス／インタフェースリポジトリのどちらか一方、または両方がリモート参照になる場合、運用形態はTYPE3に変更されます。
• ネーミングサービス／インタフェースリポジトリがともにローカル参照になる場合、運用形態はTYPE1に変更されます。
• インタフェースリポジトリをローカルにセットアップし、かつネーミングサービスがローカル参照になっている場合、インタフェースリポジトリ（valueインタフェース）が自動的にセットアップされます。
• インタフェースリポジトリの参照先をリモートホストに変更する場合、インタフェースリポジトリ（valueインタフェース）は、アンセットアップされます。
• イベントサービスを使用する場合に、esmkchnlコマンドによりイベントチャネルを作成後、ismodifyserviceコマンドでネーミングサービスの操作を行う際は、ismodifyserviceコマンド実行前にesrmchnlコマンドにより、作成済みのイベントチャネルを削除してください
  esrmchnlコマンドの詳細については、“esrmchnl”を参照してください。

• 本コマンドを使用する場合には、コントロールパネルのサービスや、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)
  • ロードバランスオプション(NS LoadBalancingOption)
  • Interstage HTTP Server (*)
  • InfoProvider Pro(F3FMwww) (*)
  • HTMLページ編集サービス(WebGateway)
    V6以降ではHTMLページ編集サービスを同梱していませんが、Windows(R)での上書きインストールの場合などは、HTMLページ編集サービスを使用できます。
  • V5.1以前のServletサービス(Interstage JServlet) (*)
  • CORBA/SOAPクライアントゲートウェイ(CORBA_SOAP ClientGW) (*)

• Interstage HTTP Serverを拡張システムに対して追加／削除することはできません。（Enterprise Editionのみ）

使用例

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

　ismodifyservice -a ES

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

　ismodifyservice -r -h host01 NS

InfoProvider Proを追加する場合

　ismodifyservice -a IPP WWWSV WWWSV.dat

InfoProvider Proを削除する場合

　ismodifyservice -d IPP WWWSV