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