servertool はアプリケーションプログラマが、永続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。

形式

servertool -ORBInitialPort nameserverport options [ commands ]

コマンドを入力しないで servertool を起動すると、コマンド行ツールとして servertool > プロンプトが表示されます。servertool > プロンプトにコマンドを入力します。

コマンドを入力して servertool を起動すると、Java IDL サーバーツールが起動し、コマンドを実行して終了します。

-ORBInitialPort nameserverport オプションは必須です。nameserverport の値には、orbd が実行され、着信要求を待機しているポートを指定する必要があります。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、nameserverport として 1024 以上のポート番号を使用することをお薦めします。

説明

servertool はアプリケーションプログラマが、永続サーバーの登録、登録解除、起動、および停止を行うためのコマンド行インタフェースを提供します。そのほかに、サーバーに関するさまざまな統計情報を取得するためのコマンドも提供します。

オプション

-ORBInitialHost nameserverhost

ネームサーバーが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、nameserverhost はデフォルトで localhost に設定されます。orbd と servertool が異なるマシン上で実行されている場合は、orbd が実行されているホストの名前と IP アドレスを指定する必要があります。

-Joption

Java 仮想マシンに option を渡します (option は、「Java アプリケーション起動ツール」のリファレンスページに記載されているいずれかのオプション)。たとえば、-J-Xms48m と指定すると、スタートアップメモリーは 48M バイトに設定されます。-J を使ってベースとなる仮想マシンにオプションを渡すことはよく行われています。

コマンド

register -server <server class name>  -classpath <classpath to server> [ -applicationName <application name> -args <args to server> -vmargs <flags to be passed to Java VM>  ]

Object Request Broker Daemon (ORBD) に新規永続サーバーを登録します。サーバーが未登録の場合、登録して起動します。このコマンドによって、-server オプションで識別されるサーバーのメインクラス内でインストールメソッドが呼び出されます。このインストールメソッドは、public static void install(org.omg.CORBA.ORB) になっている必要があります。インストールメソッドは、オプションであり、データベーススキーマの作成などの独自のサーバーインストール動作を開発者が指定できます。

unregister -serverid <server id > | -applicationName <application name>

サーバー ID またはアプリケーション名を使用して、ORBD のサーバーの登録を解除します。このコマンドによって、-server オプションで識別されるサーバーのメインクラス内でアンインストールメソッドが呼び出されます。このアンインストールメソッドは、public static void uninstall(org.omg.CORBA.ORB) になっている必要があります。アンインストールメソッドは、オプションであり、インストールメソッドの動作の取り消しなどの独自のサーバーアンインストール動作を開発者が指定できます。

getserverid -applicationName <application name>

アプリケーションに関連付けられているサーバー ID を返します。

list

ORBD に登録されているすべての永続サーバーに関する情報を一覧表示します。

listappnames

現在 ORBD に登録されているすべてのサーバーのアプリケーション名を一覧表示します。

listactive

ORDB によって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。

locate -serverid <server id > | -applicationName <application name> [-endpointType <endpointType> ]

登録されたサーバーで作成したすべての ORB の特定の型について端点 (ポート) を検出します。サーバーが実行されていない場合、起動されます。端点の型が指定されていない場合、サーバーの ORB ごとに関連付けられている plain 型または non-protected 型の端点が返されます。

locateperorb -serverid <server id > | -applicationName <application name> [-orbid <ORB name> ]

登録されたサーバーの特定の 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

サーバーがサーバーツールで使用できるすべてのコマンドを表示します。

quit

サーバーツールを終了します。

関連項目

orbd