1 '\" t |
|
2 .\" Copyright (c) 2004, 2014, Oracle and/or its affiliates. All rights reserved. |
|
3 .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
4 .\" |
|
5 .\" This code is free software; you can redistribute it and/or modify it |
|
6 .\" under the terms of the GNU General Public License version 2 only, as |
|
7 .\" published by the Free Software Foundation. |
|
8 .\" |
|
9 .\" This code is distributed in the hope that it will be useful, but WITHOUT |
|
10 .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
11 .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
12 .\" version 2 for more details (a copy is included in the LICENSE file that |
|
13 .\" accompanied this code). |
|
14 .\" |
|
15 .\" You should have received a copy of the GNU General Public License version |
|
16 .\" 2 along with this work; if not, write to the Free Software Foundation, |
|
17 .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
18 .\" |
|
19 .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
20 .\" or visit www.oracle.com if you need additional information or have any |
|
21 .\" questions. |
|
22 .\" |
|
23 .\" Title: jstatd |
|
24 .\" Language: Japanese |
|
25 .\" Date: 2013年11月21日 |
|
26 .\" SectDesc: モニタリング・ツール |
|
27 .\" Software: JDK 8 |
|
28 .\" Arch: 汎用 |
|
29 .\" Part Number: E58103-01 |
|
30 .\" Doc ID: JSSON |
|
31 .\" |
|
32 .if n .pl 99999 |
|
33 .TH "jstatd" "1" "2013年11月21日" "JDK 8" "モニタリング・ツール" |
|
34 .\" ----------------------------------------------------------------- |
|
35 .\" * Define some portability stuff |
|
36 .\" ----------------------------------------------------------------- |
|
37 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
38 .\" http://bugs.debian.org/507673 |
|
39 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
|
40 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
|
41 .ie \n(.g .ds Aq \(aq |
|
42 .el .ds Aq ' |
|
43 .\" ----------------------------------------------------------------- |
|
44 .\" * set default formatting |
|
45 .\" ----------------------------------------------------------------- |
|
46 .\" disable hyphenation |
|
47 .nh |
|
48 .\" disable justification (adjust text to left margin only) |
|
49 .ad l |
|
50 .\" ----------------------------------------------------------------- |
|
51 .\" * MAIN CONTENT STARTS HERE * |
|
52 .\" ----------------------------------------------------------------- |
|
53 .SH "名前" |
|
54 jstatd \- Java仮想マシン(JVM)をモニターし、リモート・モニタリング・ツールがJVMに接続できるようにします。このコマンドは試験的なもので、サポートされていません。 |
|
55 .SH "概要" |
|
56 .sp |
|
57 .if n \{\ |
|
58 .RS 4 |
|
59 .\} |
|
60 .nf |
|
61 \fBjstatd\fR [ \fIoptions\fR ] |
|
62 .fi |
|
63 .if n \{\ |
|
64 .RE |
|
65 .\} |
|
66 .PP |
|
67 \fIoptions\fR |
|
68 .RS 4 |
|
69 コマンド行オプション。オプションを参照してください。 |
|
70 .RE |
|
71 .SH "説明" |
|
72 .PP |
|
73 \fBjstatd\fRコマンドは、計測されたJava HotSpot VMの作成と終了をモニターし、ローカル・システム上で実行されているJVMに、リモート・モニタリング・ツールが接続できるようにするためのインタフェースを提供するRMIサーバー・アプリケーションです。 |
|
74 .PP |
|
75 \fBjstatd\fRサーバーでは、ローカル・ホストにRMIレジストリが必要になります。\fBjstatd\fRサーバーはデフォルト・ポートで、または\fB\-p\fR |
|
76 \fBport\fRオプションで指定したポートで、RMIレジストリに接続しようとします。RMIレジストリが見つからない場合、\fB\-p\fR |
|
77 \fBport\fRオプションで指定されたポート、または\fB\-p\fR |
|
78 \fBport\fRオプションが省略されている場合は、デフォルトRMIレジストリにバインドされた\fBjstatd\fRアプリケーション内に、1つのRMIレジストリが作成されます。内部RMIレジストリの作成は、\fB\-nr\fRオプションを指定することによって中止できます。 |
|
79 .SH "オプション" |
|
80 .PP |
|
81 \-nr |
|
82 .RS 4 |
|
83 既存のRMIレジストリが見つからない場合、\fBjstatd\fRプロセス内に内部RMIレジストリを作成しないようにします。 |
|
84 .RE |
|
85 .PP |
|
86 \-p \fIport\fR |
|
87 .RS 4 |
|
88 RMIレジストリがあると予想されるポート番号です。見つからない場合は、\fB\-nr\fRオプションが指定されていなければ作成されます。 |
|
89 .RE |
|
90 .PP |
|
91 \-n \fIrminame\fR |
|
92 .RS 4 |
|
93 RMIレジストリにおいて、リモートRMIオブジェクトがバインドされる名前です。デフォルト名は\fBJStatRemoteHost\fRです。複数の\fBjstatd\fRサーバーが同じホスト上で起動している場合、各サーバーのエクスポートしたRMIオブジェクトの名前は、このオプションを指定することによって、一意の名前にすることができます。ただし、このオプションを使用する場合、モニタリング・クライアントの\fBhostid\fRおよび\fBvmid\fR文字列に、その一意のサーバー名を含める必要があります。 |
|
94 .RE |
|
95 .PP |
|
96 \-J\fIoption\fR |
|
97 .RS 4 |
|
98 JVMに\fBoption\fRを渡します。optionには、Javaアプリケーション起動ツールのリファレンス・ページに記載されている\fBオプション\fRを1つ指定します。たとえば、\fB\-J\-Xms48m\fRと指定すると、スタートアップ・メモリーは48MBに設定されます。java(1)を参照してください。 |
|
99 .RE |
|
100 .SH "セキュリティ" |
|
101 .PP |
|
102 \fBjstatd\fRサーバーは、適切なネイティブ・アクセス権を持つJVMのみをモニターできます。したがって、\fBjstatd\fRプロセスは、ターゲットJVMと同じユーザー資格証明で実行されている必要があります。Solaris、LinuxおよびOS Xオペレーティング・システムにおけるrootユーザーなどの一部のユーザー資格証明は、システム上の任意のJVMによってエクスポートされたインストゥルメンテーションへのアクセス権を持っています。このような資格証明で実行されている\fBjstatd\fRプロセスは、システム上のすべてのJVMをモニターできますが、セキュリティ上の別の問題が起こります。 |
|
103 .PP |
|
104 \fBjstatd\fRサーバーには、リモート・クライアントの認証機能がありません。そのため、\fBjstatd\fRサーバー・プロセスを実行すると、\fBjstatd\fRプロセスがアクセス権を持つすべてのJVMによるインストゥルメンテーションのエクスポートを、ネットワーク上のすべてのユーザーに公開することになります。この無防備な状態は、環境によっては望ましくない場合があるので、特に本番環境またはセキュアでないネットワークでは、\fBjstatd\fRプロセスを起動する前に、ローカル・セキュリティ・ポリシーを検討する必要があります。 |
|
105 .PP |
|
106 \fBjstatd\fRサーバーは、他のセキュリティ・マネージャがインストールされていない場合には、\fBRMISecurityPolicy\fRのインスタンスをインストールします。そのため、セキュリティ・ポリシー・ファイルを指定する必要があります。ポリシー・ファイルは、http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/security/PolicyFiles\&.htmlにある |
|
107 「デフォルトのPolicyの実装とポリシー・ファイルの構文」に準拠している必要があります |
|
108 .PP |
|
109 次のポリシー・ファイルでは、セキュリティ例外を発生せずに\fBjstatd\fRサーバーを実行できます。このポリシーは、すべてのコード・ベースへのあらゆるアクセス権を認めるポリシーよりも自由度が低いですが、\fBjstatd\fRサーバーを実行するために最低限必要なアクセス権のみを認めるポリシーよりも自由度が高くなっています。 |
|
110 .sp |
|
111 .if n \{\ |
|
112 .RS 4 |
|
113 .\} |
|
114 .nf |
|
115 \fBgrant codebase "file:${java\&.home}/\&.\&./lib/tools\&.jar" { \fR |
|
116 \fB permission java\&.security\&.AllPermission;\fR |
|
117 \fB};\fR |
|
118 |
|
119 .fi |
|
120 .if n \{\ |
|
121 .RE |
|
122 .\} |
|
123 .PP |
|
124 このポリシー設定を使用するには、このテキストを\fBjstatd\&.all\&.policy\fRというファイルにコピーし、次のように\fBjstatd\fRサーバーを実行します。 |
|
125 .sp |
|
126 .if n \{\ |
|
127 .RS 4 |
|
128 .\} |
|
129 .nf |
|
130 \fBjstatd \-J\-Djava\&.security\&.policy=jstatd\&.all\&.policy\fR |
|
131 |
|
132 .fi |
|
133 .if n \{\ |
|
134 .RE |
|
135 .\} |
|
136 .PP |
|
137 より厳しいセキュリティを実施するサイトの場合、カスタム・ポリシー・ファイルを使用して、特定の信頼できるホストまたはネットワークにアクセスを制限することができます。ただし、このような方法は、IPアドレスの盗聴攻撃を受けやすくなります。セキュリティの問題について、カスタマイズしたポリシー・ファイルでも対処できない場合は、\fBjstatd\fRサーバーを実行せずに、\fBjstat\fRと\fBjps\fRツールをローカルで使用することが最も安全な方法になります。 |
|
138 .SH "リモート・インタフェース" |
|
139 .PP |
|
140 \fBjstatd\fRプロセスがエクスポートするインタフェースは、独自に開発したものであり変更される予定です。ユーザーおよび開発者は、このインタフェースへの書込みを行わないでください。 |
|
141 .SH "例" |
|
142 .PP |
|
143 次に、\fBjstatd\fRコマンドの例を示します。\fBjstatd\fRスクリプトによって、サーバーはバックグラウンドで自動的に起動します。 |
|
144 .SS "内部RMIレジストリ" |
|
145 .PP |
|
146 この例は、内部RMIレジストリを使用した\fBjstatd\fRセッションの起動方法を表しています。この例では、デフォルトのRMIレジストリ・ポート(ポート1099)には、他のサーバーはバインドされていないと想定しています。 |
|
147 .sp |
|
148 .if n \{\ |
|
149 .RS 4 |
|
150 .\} |
|
151 .nf |
|
152 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR |
|
153 |
|
154 .fi |
|
155 .if n \{\ |
|
156 .RE |
|
157 .\} |
|
158 .SS "外部RMIレジストリ" |
|
159 .PP |
|
160 この例は、外部RMIレジストリを使用した\fBjstatd\fRセッションの起動を表しています。 |
|
161 .sp |
|
162 .if n \{\ |
|
163 .RS 4 |
|
164 .\} |
|
165 .nf |
|
166 \fBrmiregistry&\fR |
|
167 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR |
|
168 |
|
169 .fi |
|
170 .if n \{\ |
|
171 .RE |
|
172 .\} |
|
173 .PP |
|
174 この例では、ポート2020の外部RMIレジストリを使用して\fBjstatd\fRセッションを起動します。 |
|
175 .sp |
|
176 .if n \{\ |
|
177 .RS 4 |
|
178 .\} |
|
179 .nf |
|
180 \fBjrmiregistry 2020&\fR |
|
181 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR |
|
182 |
|
183 .fi |
|
184 .if n \{\ |
|
185 .RE |
|
186 .\} |
|
187 .PP |
|
188 この例では、ポート2020の外部RMIレジストリを使用して、\fBAlternateJstatdServerName\fRにバインドされている\fBjstatd\fRセッションを起動します。 |
|
189 .sp |
|
190 .if n \{\ |
|
191 .RS 4 |
|
192 .\} |
|
193 .nf |
|
194 \fBrmiregistry 2020&\fR |
|
195 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-p 2020\fR |
|
196 \fB \-n AlternateJstatdServerName\fR |
|
197 |
|
198 .fi |
|
199 .if n \{\ |
|
200 .RE |
|
201 .\} |
|
202 .SS "インプロセスRMIレジストリの作成の停止" |
|
203 .PP |
|
204 この例では、外部RMIレジストリがない場合に作成しない\fBjstatd\fRセッションを起動します。この例では、RMIレジストリがすでに実行されていると想定しています。RMIレジストリが実行されていない場合、エラー・メッセージが表示されます。 |
|
205 .sp |
|
206 .if n \{\ |
|
207 .RS 4 |
|
208 .\} |
|
209 .nf |
|
210 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy \-nr\fR |
|
211 |
|
212 .fi |
|
213 .if n \{\ |
|
214 .RE |
|
215 .\} |
|
216 .SS "RMIロギングの有効化" |
|
217 .PP |
|
218 この例では、RMIロギング機能を有効化して\fBjstatd\fRセッションを起動します。この方法は、トラブルシューティングまたはサーバー活動のモニタリングに役立ちます。 |
|
219 .sp |
|
220 .if n \{\ |
|
221 .RS 4 |
|
222 .\} |
|
223 .nf |
|
224 \fBjstatd \-J\-Djava\&.security\&.policy=all\&.policy\fR |
|
225 \fB \-J\-Djava\&.rmi\&.server\&.logCalls=true\fR |
|
226 |
|
227 .fi |
|
228 .if n \{\ |
|
229 .RE |
|
230 .\} |
|
231 .SH "関連項目" |
|
232 .sp |
|
233 .RS 4 |
|
234 .ie n \{\ |
|
235 \h'-04'\(bu\h'+03'\c |
|
236 .\} |
|
237 .el \{\ |
|
238 .sp -1 |
|
239 .IP \(bu 2.3 |
|
240 .\} |
|
241 java(1) |
|
242 .RE |
|
243 .sp |
|
244 .RS 4 |
|
245 .ie n \{\ |
|
246 \h'-04'\(bu\h'+03'\c |
|
247 .\} |
|
248 .el \{\ |
|
249 .sp -1 |
|
250 .IP \(bu 2.3 |
|
251 .\} |
|
252 jps(1) |
|
253 .RE |
|
254 .sp |
|
255 .RS 4 |
|
256 .ie n \{\ |
|
257 \h'-04'\(bu\h'+03'\c |
|
258 .\} |
|
259 .el \{\ |
|
260 .sp -1 |
|
261 .IP \(bu 2.3 |
|
262 .\} |
|
263 jstat(1) |
|
264 .RE |
|
265 .sp |
|
266 .RS 4 |
|
267 .ie n \{\ |
|
268 \h'-04'\(bu\h'+03'\c |
|
269 .\} |
|
270 .el \{\ |
|
271 .sp -1 |
|
272 .IP \(bu 2.3 |
|
273 .\} |
|
274 rmiregistry(1) |
|
275 .RE |
|
276 .br |
|
277 'pl 8.5i |
|
278 'bp |
|