1 ." Copyright (c) 2001, 2011, Oracle and/or its affiliates. All rights reserved. 2 ." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 3 ." 4 ." This code is free software; you can redistribute it and/or modify it 5 ." under the terms of the GNU General Public License version 2 only, as 6 ." published by the Free Software Foundation. 7 ." 8 ." This code is distributed in the hope that it will be useful, but WITHOUT 9 ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 10 ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 11 ." version 2 for more details (a copy is included in the LICENSE file that 12 ." accompanied this code). 13 ." 14 ." You should have received a copy of the GNU General Public License version 15 ." 2 along with this work; if not, write to the Free Software Foundation, 16 ." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 17 ." 18 ." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 19 ." or visit www.oracle.com if you need additional information or have any 20 ." questions. 21 ." 22 .TH orbd 1 "07 May 2011" 23 24 .LP 25 .SH "名前" 26 orbd \- The Object Request Broker Daemon 27 .LP 28 .LP 29 \f3orbd\fP は、クライアントから CORBA 環境のサーバーにある持続オブジェクトを透過的に検索して呼び出すために使用します。 30 .LP 31 .LP 32 \f3関連項目:\fP 33 .na 34 \f2ネームサービス\fP @ 35 .fi 36 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html 37 .LP 38 .SH "形式" 39 .LP 40 .nf 41 \f3 42 .fl 43 orbd <\fP\f3options\fP\f3> 44 .fl 45 \fP 46 .fi 47 48 .LP 49 .SH "説明" 50 .LP 51 .LP 52 \f3orbd\fP ツールに含まれるサーバーマネージャーを使うと、クライアントは CORBA 環境でサーバー上にある持続オブジェクトを透過的に検索して呼び出すことができます。持続サーバーは、ネームサービスに持続オブジェクト参照を発行する際、サーバーのポート番号の代わりに OBRD のポート番号をオブジェクト参照に含めます。持続オブジェクト参照のオブジェクト参照に ORBD ポート番号を含めることには、次のような利点があります。 53 .LP 54 .RS 3 55 .TP 2 56 o 57 ネームサービスにあるオブジェクト参照が、サーバーのライフタイムと無関係になる。オブジェクト参照は、始めてインストールされたときはネームサービスのサーバーによりネームサービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、ORBD がいつでも呼び出したクライアントに正しいオブジェクト参照を返します。 58 .TP 2 59 o 60 クライアントは一度だけネーミングサービスのオブジェクト参照をルックアップする必要があるが、その後はサーバーのライフタイムによる変更とは無関係にこの参照を利用することができる 61 .RE 62 63 .LP 64 .LP 65 ORBD のサーバーマネージャーにアクセスするには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。サーバーマネージャーの詳細については、このドキュメントの「サーバーマネージャー」を参照してください。 66 .LP 67 .LP 68 \f2orbd\fP を起動すると、ネームサービスも起動されます。ネームサービスについては、 69 .na 70 \f2「ネームサービス」\fP @ 71 .fi 72 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 73 .LP 74 .SH "オプション" 75 .LP 76 .SS 77 必須オプション 78 .LP 79 .RS 3 80 .TP 3 81 \-ORBInitialPort nameserverport 82 ネームサーバーを起動するポートの番号を指定します。\f2orbd\fP は、起動されると、このポート上で着信要求を待機します。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。(必須) 83 .RE 84 85 .LP 86 .LP 87 88 .LP 89 .SS 90 その他のオプション 91 .LP 92 .RS 3 93 .TP 3 94 \-port port 95 ORBD を起動するポートを指定します。ORBD は、このポートで、持続オブジェクトに対する要求を受け取ります。このポートのデフォルト値は 1049 です。このポート番号が、持続 Interoperable Object References (IOR). のポートフィールドに追加されます。(省略可) 96 .RE 97 98 .LP 99 .RS 3 100 .TP 3 101 \-defaultdb directory 102 ORBD 持続格納ディレクトリ \f2orb.db\fP が作成されるベースディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は「./orb.db」となります。(省略可) 103 .RE 104 105 .LP 106 .RS 3 107 .TP 3 108 \-serverPollingTime milliseconds 109 \f2servertool\fP を使用して登録された持続サーバーが正常に動作していることを ORBD が確認する回数を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) 110 .RE 111 112 .LP 113 .RS 3 114 .TP 3 115 \-serverStartupDelay milliseconds 116 \f2servertool\fP を使用して登録された持続サーバーを再起動してから、位置転送の例外を送信するまでの ORBD の待機時間を指定します。デフォルト値は 1,000 ミリ秒です。\f2milliseconds\fP に指定する値は、有効な正の整数でなければなりません。(省略可) 117 .RE 118 119 .LP 120 .RS 3 121 .TP 3 122 \-Joption 123 Java 仮想マシンに \f2option\fP を渡します。\f2option\fP には、java(1)のリファレンスページに記載されているオプションを 1 つ指定します。たとえば、\f3\-J\-Xms48m\fP と指定すると、スタートアップメモリーは 48M バイトに設定されます。\f3\-J\fP を使って背後の実行環境にオプションを渡すことはよく行われています。 124 .TP 3 125 126 .RE 127 128 .LP 129 .SH "ネームサービスの起動と停止" 130 .LP 131 .LP 132 ネームサービスは、 133 .na 134 \f2CORBA オブジェクト\fP @ 135 .fi 136 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#CORBA%20objectにネーミングを可能にする CORBA サービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。 137 .na 138 \f2「ネームバインディング」\fP @ 139 .fi 140 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlGlossary.html#name%20bindingはネームサービスに格納され、クライアントは名前を与えて目的のオブジェクト参照を取得できます。 141 .LP 142 .LP 143 ORBD は、クライアントまたはサーバーを実行する前に起動します。ORBD には、持続ネームサービスおよび一時ネームサービスが組み込まれています。これらはどちらも COS ネームサービスの実装です。 144 .LP 145 .LP 146 \f3「持続」ネームサービス\fPは、ネーミングコンテキストに対して持続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBD を再起動すると、持続ネームサービスはネーミングコンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングが保持されます。 147 .LP 148 .LP 149 \ 150 .LP 151 .LP 152 下位互換性のため、旧バージョンの JDK に同梱されていた\f2一時ネームサービス\fPが、今回のリリースの J2SE にも同梱されています。一時ネームサービスでは、ネームサービスの実行中にのみネーミングコンテキストが保持されます。サービスが中断されると、ネーミングコンテキストは失われます。 153 .LP 154 .LP 155 \f2\-ORBInitialPort\fP 引数は、\f2orbd\fP の必須のコマンド行引数で、ネームサービスが実行されるポートの番号を設定するために使われます。以下の説明では、JavaIDL Object Request Broker Daemon 用にポート 1050 を使用できることを前提としています。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。必要であれば別のポートに変更してください。 156 .LP 157 .LP 158 UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。 159 .LP 160 .nf 161 \f3 162 .fl 163 orbd \-ORBInitialPort 1050& 164 .fl 165 \fP 166 .fi 167 168 .LP 169 .LP 170 Windows の MS\-DOS システムプロンプトでは、次のように入力します。 171 .LP 172 .nf 173 \f3 174 .fl 175 start orbd \-ORBInitialPort 1050 176 .fl 177 \fP 178 .fi 179 180 .LP 181 .LP 182 これで ORBD が実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネームサービスが実行されているポートの番号 (必要な場合はさらにマシン名) を認識している必要があります。これを実現する 1 つの方法は、次のコードをアプリケーションに追加することです。 183 .LP 184 .nf 185 \f3 186 .fl 187 Properties props = new Properties(); 188 .fl 189 props.put("org.omg.CORBA.ORBInitialPort", "1050"); 190 .fl 191 props.put("org.omg.CORBA.ORBInitialHost", "MyHost"); 192 .fl 193 ORB orb = ORB.init(args, props); 194 .fl 195 \fP 196 .fi 197 198 .LP 199 .LP 200 この例では、ネームサービスは、ホスト MyHost のポート 1050 上で実行されます。別の方法として、コマンド行からサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンド行オプションを使用して、「HelloApplication」を起動できます。 201 .LP 202 .nf 203 \f3 204 .fl 205 java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost 206 .fl 207 \fP 208 .fi 209 210 .LP 211 .LP 212 ネームサービスを停止するには、適切なオペレーティングシステムコマンドを使用します。たとえば、Solaris 上で \f2pkill orbd\fP \f2を実行したり、\fP \f2orbd\fP が動作中の DOS ウィンドウで Ctrl+C キーを押したりします。一時ネームサービスの場合は、サービスが終了されると、ネームサービスに登録された名前が消去される場合があります。Java IDL ネームサービスは、明示的に停止されるまで実行されます。 213 .LP 214 .LP 215 ORDB に含まれるネームサービスの詳細については、 216 .na 217 \f2「ネームサービス」\fP @ 218 .fi 219 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.htmlを参照してください。 220 .LP 221 .SH "サーバーマネージャー" 222 .LP 223 .LP 224 ORBD のサーバーマネージャーにアクセスして持続サーバーを実行するには、servertool(1) を使用してサーバーを起動する必要があります。servertool は、アプリケーションプログラマが、持続サーバーの登録、登録解除、起動、およびシャットダウンを行うためのコマンド行インタフェースです。\f2servertool\fP を使用してサーバーを起動する場合は、\f2orbd\fP が実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカルコンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 225 .LP 226 .SS 227 サーバーマネージャー: 例 228 .LP 229 .LP 230 デモ用の 231 .na 232 \f2サンプルチュートリアル\fP @ 233 .fi 234 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlExample.htmlを使用し、チュートリアルの手順に従って、\f2idlj\fP コンパイラと \f2javac\fP コンパイラを実行します。サーバーマネージャーを実行するには、次の手順に従ってアプリケーションを実行します。 235 .LP 236 .LP 237 \f2orbd\fP を起動します。 238 .LP 239 .LP 240 UNIX コマンドシェルで \f2orbd\fP を起動するには、次のように入力します。 241 .LP 242 .LP 243 \ 244 .LP 245 .nf 246 \f3 247 .fl 248 orbd \-ORBInitialPort 1050 249 .fl 250 \fP 251 .fi 252 253 .LP 254 .LP 255 Windows の MS\-DOS システムプロンプトでは、次のように入力します。 256 .LP 257 .nf 258 \f3 259 .fl 260 start orbd \-ORBInitialPort 1050 261 .fl 262 \fP 263 .fi 264 265 .LP 266 .LP 267 \f21050\fP はネームサーバーを実行するポートです。\f2\-ORBInitialPort\fP は必要なコマンド行の引数です。Solaris ソフトウェアを使用する場合、1024 より小さいポート上でプロセスを開始するには、root ユーザーになる必要があります。このため、1024 以上のポート番号を使用することをお勧めします。 268 .LP 269 .LP 270 \f2servertool\fP を起動します。 271 .LP 272 .LP 273 Hello サーバーを起動するには、次のように入力します。 274 .LP 275 .nf 276 \f3 277 .fl 278 servertool \-ORBInitialPort 1050 279 .fl 280 \fP 281 .fi 282 283 .LP 284 .LP 285 前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。\f2servertool\fP は、ネームサーバーと同じポート上で起動する必要があります。 286 .LP 287 .LP 288 \f2servertool\fP コマンド行インタフェースが表示されます。 289 .LP 290 .LP 291 292 .LP 293 .LP 294 \f2servertool\fP プロンプトから Hello サーバーを起動します。 295 .LP 296 .nf 297 \f3 298 .fl 299 servertool > register \-server HelloServer \-classpath .\-applicationName 300 .fl 301 HelloServerApName 302 .fl 303 \fP 304 .fi 305 306 .LP 307 .LP 308 \f2servertool\fP によってサーバーが登録されて、「HelloServerApName」という名前がサーバーに割り当てられ、サーバー ID が表示されます。 309 .LP 310 .LP 311 312 .LP 313 .LP 314 別の端末ウィンドウまたはプロンプトからクライアントアプリケーションを実行します。 315 .LP 316 .LP 317 \ 318 .LP 319 .nf 320 \f3 321 .fl 322 java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost 323 .fl 324 \fP 325 .fi 326 327 .LP 328 .LP 329 この例の \f2\-ORBInitialHost localhost\fP は省略することができます。ネームサーバーが Hello クライアントとして同一ホスト上で動作しているからです。ネームサーバーが別のホストで動作している場合は、IDL ネームサーバーが動作しているホストを \f2\-ORBInitialHost\fP \f2nameserverhost\fP で指定します。 330 .LP 331 .LP 332 前回の手順と同様にネームサーバー (\f2orbd\fP) のポートを指定します。たとえば \f2\-ORBInitialPort 1050\fP のようになります。 333 .LP 334 .LP 335 \ 336 .LP 337 .LP 338 \ 339 .LP 340 .LP 341 サーバーマネージャーの操作が終了したら、ネームサーバー (\f2orbd\fP) と \f2servertool\fP を停止するか終了してください。 342 .LP 343 .LP 344 DOS プロンプトで \f2orbd\fP をシャットダウンするには、サーバーを実行しているウィンドウを選択して \f2Ctrl+C\fP と入力します。UNIX シェルで \f2orbd\fP をシャットダウンするには、プロセスを検出して終了 (kill) します。サーバーを明示的に停止するまでは、呼び出し待機状態が続きます。 345 .LP 346 .LP 347 \f2servertool\fP をシャットダウンするには、 \f2quit\fP と入力してキーボードの \f2Enter\fP キーを押します。 348 .LP 349 .SH "関連項目" 350 .LP 351 .RS 3 352 .TP 2 353 o 354 .na 355 \f2ネームサービス\fP @ 356 .fi 357 http://java.sun.com/javase/6/docs/technotes/guides/idl/jidlNaming.html 358 .br 359 .TP 2 360 o 361 servertool(1) 362 .RE 363 364 .LP 365 .br 366 367 .LP 368 | 1 '\" t 2 .\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. 3 .\" Title: orbd 4 .\" Language: English 5 .\" Date: 2013年11月21日 6 .\" SectDesc: Java IDLおよびRMI-IIOPツール 7 .\" Software: JDK 8 8 .\" Arch: 汎用 9 .\" 10 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 11 .\" 12 .\" This code is free software; you can redistribute it and/or modify it 13 .\" under the terms of the GNU General Public License version 2 only, as 14 .\" published by the Free Software Foundation. 15 .\" 16 .\" This code is distributed in the hope that it will be useful, but WITHOUT 17 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 18 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 19 .\" version 2 for more details (a copy is included in the LICENSE file that 20 .\" accompanied this code). 21 .\" 22 .\" You should have received a copy of the GNU General Public License version 23 .\" 2 along with this work; if not, write to the Free Software Foundation, 24 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 25 .\" 26 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 27 .\" or visit www.oracle.com if you need additional information or have any 28 .\" questions. 29 .\" 30 .pl 99999 31 .TH "orbd" "1" "2013年11月21日" "JDK 8" "Java IDLおよびRMI-IIOPツール" 32 .\" ----------------------------------------------------------------- 33 .\" * Define some portability stuff 34 .\" ----------------------------------------------------------------- 35 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 36 .\" http://bugs.debian.org/507673 37 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html 38 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 39 .ie \n(.g .ds Aq \(aq 40 .el .ds Aq ' 41 .\" ----------------------------------------------------------------- 42 .\" * set default formatting 43 .\" ----------------------------------------------------------------- 44 .\" disable hyphenation 45 .nh 46 .\" disable justification (adjust text to left margin only) 47 .ad l 48 .\" ----------------------------------------------------------------- 49 .\" * MAIN CONTENT STARTS HERE * 50 .\" ----------------------------------------------------------------- 51 .SH "NAME" 52 orbd \- CORBA環境のサーバーにある永続オブジェクトをクライアントから検索して呼び出せるようにします。 53 .SH "概要" 54 .sp 55 .if n \{\ 56 .RS 4 57 .\} 58 .nf 59 \fIorbd\fR [ \fIoptions\fR ] 60 .fi 61 .if n \{\ 62 .RE 63 .\} 64 .PP 65 \fIoptions\fR 66 .RS 4 67 コマンドライン・オプション。オプションを参照してください。 68 .RE 69 .SH "説明" 70 .PP 71 \fIorbd\fRコマンドを使用すると、CORBA環境のサーバーにある永続オブジェクトをクライアントから透過的に検索して呼び出すことができます。orbdツールに含まれるサーバー・マネージャを使用すると、クライアントはCORBA環境でサーバー上にある永続オブジェクトを透過的に検索して呼び出すことができます。永続サーバーは、ネーミング・サービスに永続オブジェクト参照を発行する際、サーバーのポート番号のかわりにORBDのポート番号をオブジェクト参照に含めます。永続オブジェクト参照のオブジェクト参照にORBDポート番号を含めることには、次のような利点があります。 72 .sp 73 .RS 4 74 .ie n \{\ 75 \h'-04'\(bu\h'+03'\c 76 .\} 77 .el \{\ 78 .sp -1 79 .IP \(bu 2.3 80 .\} 81 ネーミング・サービスにあるオブジェクト参照が、サーバーのライフ・サイクルと無関係になります。たとえば、オブジェクト参照は、初めてインストールされたときはネーミング・サービスのサーバーによってネーミング・サービスに発行されますが、その後は、サーバーの開始またはシャットダウンの回数にかかわらず、呼び出したクライアントにORBDが正しいオブジェクト参照を返します。 82 .RE 83 .sp 84 .RS 4 85 .ie n \{\ 86 \h'-04'\(bu\h'+03'\c 87 .\} 88 .el \{\ 89 .sp -1 90 .IP \(bu 2.3 91 .\} 92 クライアントは一度のみネーミング・サービスのオブジェクト参照をルックアップする必要がありますが、その後はサーバーのライフ・サイクルによる変更とは無関係にこの参照を利用することができます。 93 .RE 94 .PP 95 ORBDのサーバー・マネージャにアクセスするには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。サーバー・マネージャの詳細は、サーバー・マネージャを参照してください。 96 .PP 97 \fIorbd\fRを起動すると、ネーミング・サービスも起動されます。ネーミング・サービスの詳細。ネーミング・サービスの起動と停止を参照してください。 98 .SH "オプション" 99 .PP 100 \-ORBInitialPort \fInameserverport\fR 101 .RS 4 102 必須。ネーム・サーバーを起動するポートの番号を指定します。\fIorbd\fRは、起動されると、このポート上で着信リクエストをリスニングします。Oracle Solarisソフトウェアでは、1024より小さいポートでプロセスを開始する場合、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 103 .RE 104 .SS "必須でないオプション" 105 .PP 106 \-port \fIport\fR 107 .RS 4 108 ORBDを起動するポートを指定します。このポートで、永続オブジェクトに対するリクエストをORBDが受け取ります。このポートのデフォルト値は1049です。このポート番号は、永続Interoperable Object References (IOR)のポート・フィールドに追加されます。 109 .RE 110 .PP 111 \-defaultdb \fIdirectory\fR 112 .RS 4 113 ORBD永続格納ディレクトリ\fIorb\&.db\fRが作成されるベース・ディレクトリを指定します。このオプションが指定されていない場合、デフォルト値は\fI\&./orb\&.db\fRになります。 114 .RE 115 .PP 116 \-serverPollingTime \fImilliseconds\fR 117 .RS 4 118 \fIservertool\fRを使用して登録された永続サーバーのヘルス状態をORBDがチェックする間隔を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 119 .RE 120 .PP 121 \-serverStartupDelay milliseconds 122 .RS 4 123 \fIservertool\fRを使用して登録された永続サーバーを再起動してから、位置転送の例外を送信するまでのORBDの待機時間を指定します。デフォルト値は1000ミリ秒です。\fImilliseconds\fRに指定する値は、有効な正の整数にする必要があります。 124 .RE 125 .PP 126 \-J\fIoption\fR 127 .RS 4 128 Java仮想マシンに\fIoption\fRを渡します。\fIoption\fRには、Javaアプリケーション起動ツールのリファレンス・ページに記載されているオプションを1つ指定します。たとえば、\fI\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 129 .RE 130 .SS "ネーミング・サービスの起動と停止" 131 .PP 132 ネーミング・サービスは、CORBAオブジェクトにネーミングを可能にするCORBAサービスです。ネーミングは名前をオブジェクト参照にバインドすることにより可能になります。ネーム・バインディングをネーミング・サービスに格納すれば、クライアントが名前を指定して目的のオブジェクト参照を取得できるようになります。 133 .PP 134 クライアントまたはサーバーを実行する前に、ORBDを起動します。ORBDには、永続ネーミング・サービスおよび一時ネーミング・サービスが組み込まれています。これらはどちらもCOSネーミング・サービスの実装です。 135 .PP 136 永続ネーミング・サービスは、ネーミング・コンテキストに対して永続性を提供します。つまり、この情報は、サービスの停止や起動後にも維持され、サービスに障害が発生した場合でも回復できます。ORBDを再起動すると、永続ネーミング・サービスはネーミング・コンテキストのグラフを復元し、すべてのクライアントとサーバーの名前のバインディングがそのまま(永続的に)保持されるようにします。 137 .PP 138 下位互換性のため、旧リリースのJDKに同梱されていた一時ネーミング・サービス\fItnameserv\fRが、今回のリリースのJava SEにも同梱されています。一時ネーム・サービスでは、ネーム・サービスの実行中にのみネーミング・コンテキストが保持されます。サービスが中断されると、ネーミング・コンテキスト・グラフは失われます。 139 .PP 140 \fI\-ORBInitialPort\fR引数は、\fIorbd\fRの必須のコマンドライン引数で、ネーミング・サービスが実行されるポートの番号を設定するために使用されます。次の手順では、Java IDL Object Request Broker Daemon用にポート1050を使用できることを前提としています。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。必要であれば別のポートに変更してください。 141 .PP 142 UNIXコマンド・シェルで\fIorbd\fRを起動するには、次のように入力します。 143 .sp 144 .if n \{\ 145 .RS 4 146 .\} 147 .nf 148 orbd \-ORBInitialPort 1050& 149 .fi 150 .if n \{\ 151 .RE 152 .\} 153 .PP 154 WindowsのMS\-DOSシステム・プロンプトでは、次のように入力します。 155 .sp 156 .if n \{\ 157 .RS 4 158 .\} 159 .nf 160 start orbd \-ORBInitialPort 1050 161 .fi 162 .if n \{\ 163 .RE 164 .\} 165 .PP 166 これでORBDが実行され、サーバーとクライアントのアプリケーションを実行できるようになります。クライアントとサーバーのアプリケーションは、実行時に、ネーミング・サービスが実行されているポートの番号(必要な場合はさらにマシン名)を認識している必要があります。これを実現する1つの方法は、次のコードをアプリケーションに追加することです。 167 .sp 168 .if n \{\ 169 .RS 4 170 .\} 171 .nf 172 Properties props = new Properties(); 173 props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050"); 174 props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost"); 175 ORB orb = ORB\&.init(args, props); 176 .fi 177 .if n \{\ 178 .RE 179 .\} 180 .PP 181 この例では、ネーミング・サービスは、ホスト\fIMyHost\fRのポート1050上で実行されます。別の方法として、コマンドラインからサーバーまたはクライアントのアプリケーションを実行するときに、ポート番号またはマシン名あるいはその両方を指定する方法もあります。たとえば、次のコマンドライン・オプションを使用して、\fIHelloApplication\fRを起動できます。 182 .sp 183 .if n \{\ 184 .RS 4 185 .\} 186 .nf 187 java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost 188 .fi 189 .if n \{\ 190 .RE 191 .\} 192 .PP 193 ネーミング・サービスを停止するには、適切なオペレーティング・システム・コマンドを使用します。たとえば、Oracle Solaris上で\fIpkill\fR 194 \fIorbd\fRを実行したり、\fIorbd\fRが動作中のDOSウィンドウで\fB[Ctrl]+[C]\fRキーを押します。一時ネーミング・サービスの場合は、サービスが終了されると、ネーミング・サービスに登録された名前が消去される場合があります。Java IDLネーム・サービスは、明示的に停止されるまで実行されます。 195 .PP 196 ORBDに付属するネーミング・サービスの詳細は、 197 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの「Naming Service」を参照してください 198 .SH "サーバー・マネージャ" 199 .PP 200 ORBDのサーバー・マネージャにアクセスして、永続サーバーを実行するには、\fIservertool\fRを使用してサーバーを起動する必要があります。servertoolは、アプリケーション・プログラマが、永続サーバーの登録、登録解除、起動および停止を行うためのコマンドライン・インタフェースです。\fIservertool\fRを使用してサーバーを起動する場合は、\fIorbd\fRが実行されている場所と同じポートとホストで起動する必要があります。サーバーを異なるポートで実行すると、ローカル・コンテキスト用にデータベースに保存されている情報が無効になり、サービスが正しく動作しません。 201 .PP 202 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.htmlの 203 「Java IDL: The "Hello World" Example」を参照してください 204 .PP 205 この例では、チュートリアルの手順に従って\fIidlj\fRコンパイラと\fIjavac\fRコンパイラを実行します。ORBDのサーバー・マネージャを実行するには、次の手順に従ってアプリケーションを実行します。 206 .PP 207 \fIorbd\fRを起動します。 208 .PP 209 UNIXコマンド・シェルで次のように入力します: 210 \fIorbd \-ORBInitialPort 1050\fR。 211 .PP 212 MS\-DOSシステム・プロンプト(Windows)で次のように入力します: 213 \fIs\fR\fItart orbd \-ORBInitialPort 105\fR\fI0\fR 214 .PP 215 ポート1050はネーム・サーバーを実行するポートです。\fI\-ORBInitialPort\fRオプションは必須コマンドライン引数です。Oracle Solarisソフトウェアを使用する場合、1024より小さいポートでプロセスを開始するには、rootユーザーになる必要があります。このため、1024以上のポート番号を使用することをお薦めします。 216 .PP 217 \fIservertool\fRを起動します: 218 \fIservertool \-ORBInitialPort 1050\fR。 219 .PP 220 前回の手順とネーム・サーバー(\fIorbd\fR)のポートが同じであることを確認します。たとえば\fI\-ORBInitialPort 1050\&.\fRのようになります。\fIservertool\fRは、ネーム・サーバーと同じポート上で起動する必要があります。 221 .PP 222 \fIservertool\fRコマンドライン・インタフェースで、\fIservertool\fRプロンプトから\fIHello\fRサーバーを起動します。 223 .sp 224 .if n \{\ 225 .RS 4 226 .\} 227 .nf 228 servertool > register \-server HelloServer \-classpath \&. \-applicationName 229 HelloServerApName 230 .fi 231 .if n \{\ 232 .RE 233 .\} 234 .PP 235 \fIservertool\fRによってサーバーが登録されて、\fIHelloServerApName\fRという名前がサーバーに割り当てられ、登録されているすべてのサーバー一覧とともにサーバーIDが表示されます。他の端末ウィンドウまたはプロンプトからクライアント・アプリケーションを実行します。 236 .sp 237 .if n \{\ 238 .RS 4 239 .\} 240 .nf 241 java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost 242 .fi 243 .if n \{\ 244 .RE 245 .\} 246 .PP 247 この例の\fI\-ORBInitialHost localhost\fRは省略することができます。ネーム・サーバーが\fIHello\fRクライアントとして同一ホスト上で動作しているからです。ネーム・サーバーが別のホストで実行されている場合は、\-\fIORBInitialHost nameserverhost\fRオプションを使用してIDLネーム・サーバーが実行されているホストを指定します。前の手順で行われたとおりにネーム・サーバー(\fIorbd\fR)ポートを指定します(例: 248 \fI\-ORBInitialPort 1050\fR)。ORBDのサーバー・マネージャの操作が終了したら、ネーム・サーバー(\fIorbd\fR)と\fIservertool\fRを停止するか終了してください。MS\-DOSプロンプトで\fIorbd\fRをシャットダウンするには、サーバーを実行しているウィンドウを選択して\fB[Ctrl]+[C]\fRキーを押します。 249 .PP 250 Oracle Solarisから\fIorbd\fRをシャットダウンするには、プロセスを検索して、\fIkill\fRコマンドで終了します。サーバーを明示的に停止するまでは、呼出し待機状態が続きます。\fIservertool\fRをシャットダウンするには、\fBquit\fRと入力してキーボードの\fB[Enter]\fRキーを押します。 251 .SH "関連項目" 252 .sp 253 .RS 4 254 .ie n \{\ 255 \h'-04'\(bu\h'+03'\c 256 .\} 257 .el \{\ 258 .sp -1 259 .IP \(bu 2.3 260 .\} 261 servertool(1) 262 .RE 263 .sp 264 .RS 4 265 .ie n \{\ 266 \h'-04'\(bu\h'+03'\c 267 .\} 268 .el \{\ 269 .sp -1 270 .IP \(bu 2.3 271 .\} 272 http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.htmlの 273 「Naming Service」 274 .RE 275 .br 276 'pl 8.5i 277 'bp |