servertool - Java(TM) IDL サーバツール

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

形式

servertool -ORBInitialPort nameserverport options [ commands ]

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

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

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

説明

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

オプション

-ORBInitialHost nameserverhost
ネームサーバが、実行され、着信要求を待機しているホストマシンを指定します。このオプションを指定しない場合、nameserverhost はデフォルトで localhost に設定されます。orbdservertool が異なるマシン上で実行されている場合は、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


Copyright © 2001-2004 Sun Microsystems, Inc. All Rights Reserved.

Sun
Java ソフトウェア