servertool(1)

名前
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以上のポート番号を使用することをお薦めします。

説明

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

オプション

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

    -Joption
        Java仮想マシンにoptionを渡します。optionには、java(1)のリファレンス・ページに記載されているオプションを1つ指定します。たとえば、-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
        ORBDによって起動され、現在実行されているすべての永続サーバーに関する情報を一覧表示します。

    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(1)