|
1 '\" t |
|
2 .\" |
|
3 .\" Copyright 2001-2006 Sun Microsystems, Inc. All Rights Reserved. |
|
4 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
5 .\" |
|
6 .\" This code is free software; you can redistribute it and/or modify it |
|
7 .\" under the terms of the GNU General Public License version 2 only, as |
|
8 .\" published by the Free Software Foundation. |
|
9 .\" |
|
10 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
|
11 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
12 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
13 .\" version 2 for more details (a copy is included in the LICENSE file that |
|
14 .\" accompanied this code). |
|
15 .\" |
|
16 .\" You should have received a copy of the GNU General Public License version |
|
17 .\" 2 along with this work; if not, write to the Free Software Foundation, |
|
18 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
19 .\" |
|
20 .\" Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, |
|
21 .\" CA 95054 USA or visit www.sun.com if you need additional information or |
|
22 .\" have any questions. |
|
23 .\" |
|
24 .\" |
|
25 .TH servertool 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド" |
|
26 .SH "名前" |
|
27 servertool - Java(TM) IDL サーバツール |
|
28 .LP |
|
29 .B servertool |
|
30 は、アプリケーション開発者が持続サーバの登録、登録解除、起動、停止を行うためのコマンド行インタフェースを提供します。 |
|
31 .SH "形式" |
|
32 .B servertool |
|
33 \-ORBInitialPort nameserverport options [ commands ] |
|
34 .LP |
|
35 .B servertool |
|
36 の起動時にコマンドを |
|
37 入力しなかった場合は、 |
|
38 コマンド行ツールが |
|
39 .B servertool > |
|
40 プロンプトを表示します。 |
|
41 .B servertool > |
|
42 プロンプトで |
|
43 コマンドを入力します。 |
|
44 .LP |
|
45 .B servertool |
|
46 の起動時にコマンドを入力した場合は、 |
|
47 Java IDL サーバツールが起動し、 |
|
48 コマンドを実行して終了します。 |
|
49 .LP |
|
50 \-ORBInitialPort nameserverport オプションは、必須です。 |
|
51 nameserverport の値は、orbd を実行し、 |
|
52 着信要求を待機しているポートを指定します。 |
|
53 Solaris ソフトウェアを使用する場合は、 |
|
54 スーパーユーザになって 1024 未満のポートでプロセスを開始する |
|
55 必要があります。このため、1024 以上のポート番号の |
|
56 使用を推奨します。 |
|
57 .SH 機能説明 |
|
58 .BR servertool |
|
59 はアプリケーション |
|
60 プログラマが、持続サーバの登録、登録解除、起動、停止を |
|
61 行うためのコマンド行インタフェースです。 |
|
62 サーバに関するさまざまな統計情報を取得するために |
|
63 その他のコマンドが用意されています。 |
|
64 .SH オプション |
|
65 .TP |
|
66 .BI \-ORBInitialHost " nameserverhost" |
|
67 ネームサーバを実行し、着信要求を待機している |
|
68 ホストマシンを指定します。このオプションを |
|
69 指定しない場合、nameserverhost はデフォルトの |
|
70 localhost になります。 |
|
71 .B orbd |
|
72 と |
|
73 .B servertool |
|
74 が異なるマシンで実行されている場合は、orbd が |
|
75 実行されているホストの名前または IP アドレスを |
|
76 指定する必要があります。 |
|
77 .TP |
|
78 .BI \-J option |
|
79 オプションを Java 仮想マシンに渡します。 |
|
80 ここで option は、Java アプリケーション |
|
81 起動プログラム |
|
82 .fi |
|
83 (http://java.sun.com/javase/6/docs/technotes/tools/solaris/java.html) |
|
84 のリファレンスページで説明されている |
|
85 オプションの 1 つです。 |
|
86 たとえば、\-J-Xms48m は、 |
|
87 起動メモリを 48M バイトに設定します。 |
|
88 \-J が基本にする仮想マシンにオプションを |
|
89 渡すことは、共通の規約です。 |
|
90 .SH コマンド |
|
91 .TP |
|
92 .B register \-server <server class name> |
|
93 .B \-classpath <classpath to server> |
|
94 [ |
|
95 .B \-applicationName <application\ name> |
|
96 .B \-args <args to server> |
|
97 .B \-vmargs <flags to be passed |
|
98 .B to Java VM> |
|
99 ] |
|
100 .RS |
|
101 .LP |
|
102 新しい持続サーバを Object Request Broker Daemon (ORBD) に登録します。 |
|
103 まだ登録されていない場合は、サーバが登録され、有効化されます。 |
|
104 このコマンドを使用すると、 |
|
105 \-server オプションによって |
|
106 識別されるサーバのメインクラスでインストールメソッドが |
|
107 呼び出されます。インストールメソッドは、 |
|
108 public static void install (org.omg.CORBA.ORB) で |
|
109 なければなりません。このインストールメソッドを |
|
110 オプションで使用すると、開発者は独自の |
|
111 サーバインストール動作 (データベーススキーマの作成など) |
|
112 を指定できます。 |
|
113 .RE |
|
114 .TP |
|
115 .B unregister \-serverid <server id > |
|
116 .B | \-applicationName <application\ name> |
|
117 .RS |
|
118 .LP |
|
119 サーバ ID またはアプリケーション名を使用して、 |
|
120 ORBD からサーバを登録解除します。 |
|
121 このコマンドを使用すると、\-server オプションによって |
|
122 識別されたサーバのメインクラスでアンインストール |
|
123 メソッドが呼び出されます。アンインストールメソッドは、 |
|
124 public static void uninstall(org.omg.CORBA.ORB) |
|
125 でなければなりません。このアンインストールメソッドを |
|
126 オプションで使用すると、 |
|
127 開発者は独自のサーバアンインストール動作 |
|
128 (インストールメソッドの動作の取り消しなど) |
|
129 を指定できます。 |
|
130 .RE |
|
131 .TP |
|
132 .B getserverid \-applicationName <application name> |
|
133 アプリケーションに対応するサーバ ID を返します。 |
|
134 .TP |
|
135 .B list |
|
136 .br |
|
137 ORBD に登録されているすべての持続サーバに関する情報を |
|
138 一覧表示します。 |
|
139 .TP |
|
140 .B listappnames |
|
141 ORBD に現在登録されているすべてのサーバのアプリケーション名を |
|
142 一覧表示します。 |
|
143 .TP |
|
144 .B listactive |
|
145 ORBD によって起動され、稼動しているすべての |
|
146 持続サーバに関する情報を |
|
147 すべて一覧表示します。 |
|
148 .TP 3 |
|
149 locate \-serverid\ <server\ id\ >\ | |
|
150 \-applicationName\ <application\ name> |
|
151 [\-endpointType\ <endpointType>\ ] |
|
152 .RS |
|
153 .LP |
|
154 登録されているサーバによって作成されたすべての ORB の特定のタイプ |
|
155 のエンドポイント (ポート) を特定します。サーバがまだ稼動していな |
|
156 い場合は、起動されます。エンドポイントタイプが指定されないと、サ |
|
157 ーバ内の各 ORB に関連したプレーン/非保護の |
|
158 エンドポイントが返されます。 |
|
159 .RE |
|
160 .TP 3 |
|
161 locateperorb |
|
162 \-serverid\ <server\ id\ >\ | |
|
163 \-applicationName\ <application\ name> |
|
164 [\-orbid\ <ORB\ name>\ ] |
|
165 登録されているサーバの特定の ORB によって登録されたすべてのエンド |
|
166 ポイント (ポート) を特定します。サーバがまだ動作していない場合は、 |
|
167 起動されます。 |
|
168 .BR orbid |
|
169 が指定されないと、デフォルト値である "" が |
|
170 .BR orbid |
|
171 に割り当てられます。空の文字列の |
|
172 .BR orbid |
|
173 を使用して ORB が作成されると、それによって登録されているす |
|
174 べてのポートが返されます。 |
|
175 .RE |
|
176 .TP |
|
177 .B orblist \-serverid <server id> | |
|
178 .B \-applicationName <application name> ] |
|
179 .RS |
|
180 .LP |
|
181 サーバで定義されている ORB の ORBId を一覧表示します。 |
|
182 ORBId は、サーバによって作成された ORB の |
|
183 文字列名です。サーバがまだ稼動していない場合は、 |
|
184 サーバを起動します。 |
|
185 .RE |
|
186 .TP |
|
187 .B shutdown \-serverid <server id> | |
|
188 .B \-applicationName <application name> ] |
|
189 .RS |
|
190 .LP |
|
191 ORBD に登録されているアクティブなサーバを停止します。 |
|
192 このコマンドの |
|
193 実行中に、 |
|
194 サーバプロセスを適切に停止するために、 |
|
195 \-serverid または \-applicationName パラメータで |
|
196 指定されたクラスで定義されている |
|
197 .BR shutdown() |
|
198 メソッドも呼び出されます。 |
|
199 .RE |
|
200 .TP |
|
201 .B startup \-serverid <server id> | |
|
202 .B \-applicationName <application name> |
|
203 .RS |
|
204 .LP |
|
205 ORBD に登録されているサーバを起動します。 |
|
206 サーバが稼動していな |
|
207 い場合、このコマンドはサーバを起動します。サーバが既に稼動して |
|
208 いる場合は、エラーメッセージがユーザに返されます。 |
|
209 .RE |
|
210 .TP |
|
211 .B help |
|
212 .br |
|
213 このサーバツールを使用してサーバに対して実行できるすべての |
|
214 コマンドを一覧表示します。 |
|
215 .TP |
|
216 .B quit |
|
217 .br |
|
218 このサーバツールを終了します。 |
|
219 .RE |
|
220 .SS "関連項目" |
|
221 .LP |
|
222 |
|
223 .LP |
|
224 orbd |
|
225 .LP |
|
226 |