rmid - Java RMI 起動システムデーモン

rmid は、起動システムデーモンを開始し、オブジェクトを Java VM に登録して起動できるようにします。

形式

rmid [-port port] [-log dir]

解説

rmid ツールは、起動システムデーモンを開始します。起動可能なオブジェクトを起動システムに登録したり、Java VM でアクティブにしたりするには、あらかじめ起動システムデーモンを開始しておく必要があります。起動可能なリモートオブジェクトを使ったプログラムの作成方法についての詳細は、RMI の仕様を参照してください。起動システムデーモンは、次のようにオプションなしで rmid コマンドを実行することによって開始できます。

rmid

このコマンドはアクティベータを起動するとともにデフォルトポートの 1098 で内部レジストリを開始し、ActivationSystem を java.rmi.activation.ActivationSystem という名前に内部レジストリ上でバインドします。レジストリにほかのポートを指定するには、rmid の起動時に -port オプションを指定しなければなりません。たとえば、次のようにします。

rmid -port 1099

このコマンドは、起動システムデーモンを開始し、レジストリのデフォルトポート 1099 でレジストリを開始します。

オプション

-C<someCommandLineOption>

rmid の子プロセス (起動グループ) が作成されたときに、各子プロセスにコマンド行引数として渡されるオプションを指定します。たとえば、次のように指定すると、起動システムデーモンによって生成される各 Java Virtual Machine にプロパティを渡すことができます。

rmid -C-Dsome.property=value

コマンド行引数を子プロセスに渡す機能は、デバッグを行う場合に便利です。たとえば、次のようなコマンドを実行できます。

rmid -C-Djava.rmi.server.logCalls=true

このコマンドによって、すべての子 Java Virtual Machine でサーバコールのログが残されるようになります。

-log dir

起動システムデーモンがデータベースおよび関連情報を書き込むのに使う、ディレクトリの名前を指定します。デフォルトでは、rmid コマンドを実行したディレクトリに log というログディレクトリが作成されます。

-port port

rmid のレジストリが使うポートを指定します。起動システムデーモンは、java.rmi.activation.ActivationSystem という名前で ActivationSystem をレジストリにバインドします。したがって、ローカルマシンの ActivationSystem は、次のように Naming.lookup メソッドを呼び出すことによって取得できます。

import java.rmi.*;
import java.rmi.activation.*;

ActivationSystem system;
system = (ActivationSystem)
    Naming.lookup("//:port/java.rmi.activation.ActivationSystem");

-stop

-port オプションによって指定されたポートの、現在の rmid の呼び出しを停止します。ポートの指定がない場合は、ポート 1098 で実行されている rmid を停止します。

環境変数

CLASSPATH

ユーザ定義クラスへのパスをシステムに指定します。ディレクトリはコロンで分割します。次に例を示します。

.:/usr/local/java/classes

関連項目

rmic