annotate src/linux/doc/man/ja/orbd.1 @ 11881:5d018ec41792

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