servertool
コマンド行ツールは、永続サーバーを登録、登録解除、起動および停止する場合に使用します。
形式
servertool -ORBInitialPort nameserverport [ options ] [ commands ]
options
コマンド行オプションです。「servertoolのオプション」を参照してください。
commands
コマンド行コマンドです。「servertoolコマンドの使用方法」を参照してください。
コマンドを入力しないでservertool
を起動すると、コマンド行ツールとしてservertool>
プロンプトが表示されます。servertool >
プロンプトにコマンドを入力します。
コマンドを入力してservertool
を起動すると、Java IDLサーバー・ツールが起動し、コマンドを実行して終了します。
-ORBInitialPort nameserverport
オプションは必須です。nameserverport
の値には、orbd
が実行され、着信要求を待機しているポートを指定する必要があります。
注意:
Oracle Solarisの場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。nameserverport
の値として1024以上のポート番号を使用することをお薦めします。
説明
servertool
コマンドは、開発者が永続サーバーを登録、登録解除、起動およびシャットダウンするためのコマンド行インタフェースを提供します。コマンド行コマンドを使って、サーバーに関する様々な統計情報を取得できます。「servertoolコマンドの使用方法」を参照してください。
servertoolのオプション
-ORBInitialHost nameserverhost
このオプションは、ネーム・サーバーが稼働し、着信要求をリスニングするホスト・マシンを指定する場合に必要です。nameserverport
の値には、orb
が実行され、要求を待機しているポートを指定する必要があります。このオプションを指定しない場合のデフォルト値はlocalhost
です。orbd
とservertool
が異なるマシン上で実行されている場合は、orbd
が実行されているホストの名前またはIPアドレスを指定する必要があります。
注意:
Oracle Solarisの場合、1024より小さいポート上でプロセスを開始するには、rootユーザーになる必要があります。nameserverport
の値として1024以上のポート番号を使用することをお薦めします。
-Joption
Java仮想マシンにoption
を渡します(option
は、Javaアプリケーション起動ツールのリファレンス・ページに記載されているいずれかのオプション)。たとえば、-J-Xms48m
と指定すると、スタートアップ・メモリーは48Mバイトに設定されます。「java」を参照してください。
servertoolコマンドの使用方法
servertool
コマンドは、コマンド行コマンドを指定して起動することも、指定せずに起動することもできます。
コマンドを指定せずにservertool
を起動した場合は、コマンド行ツールでコマンドを入力できるservertool
プロンプト(servertool >
)が表示されます。
コマンドを指定してservertool
を起動した場合は、Java IDLサーバー・ツールが起動し、コマンドを実行して終了します。
register -server server-class-name -classpath classpath-to-server [ -applicationName application-name -args args-to-server -vmargs flags-for-JVM ]
Object Request Broker Daemon (ORBD)に新規永続サーバーを登録します。サーバーが未登録の場合、登録されて起動されます。このコマンドによって、-server
オプションで識別されるサーバーのmain
クラス内でインストール・メソッドが呼び出されます。このインストール・メソッドは、public static void install(org.omg.CORBA.ORB)
になっている必要があります。インストール・メソッドはオプションであり、データベース・スキーマの作成などの独自のサーバー・インストール動作を開発者が指定できます。
unregister -serverid server-id | -applicationName application-name
サーバーIDまたはアプリケーション名を使用してORBDからサーバーの登録を解除します。このコマンドによって、-server
オプションで識別されるサーバーのmain
クラス内でアンインストール・メソッドが呼び出されます。このuninstall
メソッドは、public static void uninstall(org.omg.CORBA.ORB)
になっている必要があります。uninstall
メソッドはオプションであり、install
メソッドの動作を元に戻すなどの独自のサーバー・アンインストール動作を開発者が指定できます。
getserverid -applicationName application-name
application-name
の値に対応するサーバーIDを返します。
list
ORBDに登録されているすべての永続サーバーに関する情報を一覧表示します。
listappnames
現在ORBDに登録されているすべてのサーバーのアプリケーション名を一覧表示します。
listactive
ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。
locate -serverid server-id | -applicationName application-name [ -endpointTypeendpointType ]
登録されたサーバーで作成したすべてのORBの特定の型について端点(ポート)を検出します。サーバーが実行されていない場合、起動されます。endpointType
の値を指定しなかった場合、サーバーのORBごとに関連付けられているplain型またはnon-protected型のエンドポイントが返されます。
locateperorb -serverid server-id | -applicationName application-name [ -orbidORB-name ]
登録されたサーバーの特定のObject Request Broker (ORB)で登録されたすべてのエンドポイント(ポート)を検出します。サーバーが実行されていない場合、起動されます。orbid
を指定しなかった場合は、デフォルト値の""
がorbid
に割り当てられます。ORBのいずれかが空文字列のorbid
で作成されている場合、登録したポートがすべて返されます。
orblist -serverid server-id | -applicationName application-name
サーバー上に定義されたORBのORBId
を一覧表示します。ORBId
はサーバーで作成されたORBの文字列名です。サーバーが実行されていない場合、起動されます。
shutdown -serverid server-id | -applicationName application-name
ORBDに登録されたアクティブなサーバーを停止します。このコマンドの実行中に、-serverid
または-applicationName
パラメータで指定されたクラス内に定義されたshutdown
メソッドも呼び出されてサーバー・プロセスをシャットダウンします。
startup -serverid server-id | -applicationName application-name
ORBDに登録されたサーバーを起動します。サーバーが実行されていない場合は、このコマンドでサーバーが起動されます。サーバーがすでに実行されている場合は、エラー・メッセージが表示されます。
help
サーバーでservertool
コマンドで使用できるすべてのコマンドを一覧表示します。
quit
servertool
コマンドを終了します。