comparison src/linux/doc/man/ja/jstatd.1 @ 0:37a05a11f281

Initial load
author duke
date Sat, 01 Dec 2007 00:00:00 +0000
parents
children b056c42ea5b4
comparison
equal deleted inserted replaced
-1:000000000000 0:fb2deaf1e211
1 '\" t
2 .\"
3 .\" Copyright 2004-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 jstatd 1 "2006 年 9 月 4 日" "Java SE 6" "ユーザーコマンド"
26 .SH 名前
27 jstatd \- 仮想マシン jstat デーモン
28 .\"
29 .SH 形式
30 .B jstatd
31 .BI [ options ]
32 .SH パラメータ
33 .if t .TP 20
34 .if n .TP 15
35 .BI options
36 コマンド行オプション。オプションは任意の順序で指定できます。冗長または矛盾するオプションがあった場合は、最後に指定されたオプションが優先されます。
37 .SH 機能説明
38 .B jstatd
39 ツールは、計測機構付き HotSpot Java 仮想マシン (JVM) の作成と終了を監視する RMI サーバーアプリケーションであり、リモート監視ツールがローカルホスト上で実行している JVM にアタッチするためのインタフェースを備えています。
40 .LP
41 jstatd サーバーが機能するためには、ローカルホスト上に RMI レジストリが存在する必要があります。jstatd サーバーは、デフォルトポートまたは
42 .BI \-p " port"
43 オプションによって示されたポート上の RMI レジストリへのアタッチを試みます。RMI レジストリが見つからなかった場合は、
44 .BI \-p " port"
45 オプションによって示されたポートにバインドされた jstatd アプリケーション内で作成され、
46 .BI \-p " port"
47 が省かれた場合はデフォルトの RMI レジストリにバインドされた jstatd アプリケーション内で作成されます。内部 RMI レジストリの作成は、
48 .B \-nr
49 オプションを指定することによって禁止できます。
50 .LP
51 注 - このユーティリティはサポートされていないため、JDK の将来のバージョンでは使用できない可能性があります。現時点では、Windows 98 および Windows ME プラットフォームでは使用できません。
52 .SH オプション
53 .B jstatd
54 コマンドは、以下のオプションをサポートします。
55 .if t .TP 20
56 .if n .TP 15
57 .BI \-nr
58 既存の RMI レジストリが見つからないときに、
59 .B jstatd
60 プロセス内での内部 RMI レジストリの作成を試みません。
61 .if t .TP 20
62 .if n .TP 15
63 .BI \-p " port"
64 RMI レジストリを探すポート番号。または、RMI レジストリが見つからず、
65 .B \-nr
66 が指定されなかった場合に、RMI レジストリが作成されるポート番号。
67 .if t .TP 20
68 .if n .TP 15
69 .BI \-n " rminame"
70 RMI レジストリでリモート RMI オブジェクトがバインドされる名前。デフォルトの名前は、JStatRemoteHost です。同じホスト上で複数の
71 .B jstatd
72 サーバーが起動している場合、各サーバーのエクスポート RMI オブジェクトの名前を一意にするには、このオプションを指定します。ただし、そのためには、監視クライアントの hostid および vmid 文字列に一意のサーバー名が含まれている必要があります。
73 .if t .TP 20
74 .if n .TP 15
75 .BI \-J option
76 .I option
77
78 .B javac
79 によって呼び出された java 起動ツールに渡します。たとえば、
80 .B \-J-Xms48m
81 は、起動メモリを 48M バイトに設定します。Java で作成された下層の VM 実行アプリケーションにオプションを渡すのが、
82 .B \-J
83 の一般的規則です。
84 .SH セキュリティ
85
86 .B jstatd
87 サーバーは、適切なネイティブアクセス権を持っている JVM だけを監視できます。
88 このため、jstatd プロセスは、ターゲット JVM と同じユーザー資格で実行している必要があります。
89 UNIX(TM) ベースのシステムの root ユーザーなど、一部のユーザー資格には、
90 そのシステム上の任意の JVM によってエクスポートされた計測機構への
91 アクセス権が割り当てられています。
92 このような資格で実行中の jstatd プロセスは、そのシステム上の任意の JVM を監視できますが、
93 これに伴うセキュリティ上の問題も考慮する必要があります。
94 .LP
95 jstatd サーバーは、リモートクライアントの認証は行いません。
96 つまり、jstatd サーバープロセスを実行すると、
97 jstatd プロセスがアクセス権を持つすべての JVM から
98 エクスポートされる計測機構が、ネットワーク上の任意のユーザーに公開されます。
99 計測機構が公開されると、環境によっては望ましくない場合があります。
100 特に運用環境や安全性の低いネットワークでは、
101 jstatd プロセスを開始する前に
102 ローカルセキュリティポリシーを検討する必要があります。
103 .LP
104 .B jstatd
105 サーバーは、他にセキュリティマネージャがインストールされていない場合は、RMISecurityPolicy のインスタンスをインストールするので、セキュリティポリシーファイルを指定する必要があります。
106 ポリシーファイルは、デフォルトのポリシー実装のポリシーファイル構文
107 .fi
108 (http://java.sun.com/javase/6/docs/technotes/guides/security/PolicyFiles.html)
109 に従う必要があります。
110 .LP
111 次のポリシーファイルでは、
112 .B jstatd
113 サーバーはセキュリティ例外を起こさずに実行できます。このポリシーは、
114 すべてのコードベースへのすべてのアクセス権を許可するよりは自由度が低いですが、
115 .B jstatd
116 サーバーの実行に必要な最小限度のアクセス権を許可するポリシーよりは自由度が高いです。
117 .LP
118 .RS
119 .ft 3
120 .nf
121 grant codebase "file:${java.home}/../lib/tools.jar" {
122 permission java.security.AllPermission;
123 };
124 .fi
125 .ft 1
126 .RE
127 .LP
128 このポリシーを使用するには、テキストを jstatd.all.policy という名前のファイルにコピーしたあと、次のようにして
129 .B jstatd
130 サーバーを実行します。
131 .LP
132 .RS
133 .ft 3
134 .nf
135 jstatd -J-Djava.security.policy=jstatd.all.policy
136 .fi
137 .ft 1
138 .RE
139 .LP
140 より厳格なセキュリティを採用しているサイトでは、
141 カスタムポリシーファイルを使用して、特定の信頼できるホストまたはネットワークに
142 アクセスを制限できます。ただし、この方法を使用しても、
143 IP アドレスのスプーフィング攻撃にさらされます。
144 カスタムポリシーファイルを使用することでセキュリティの問題に対応できない場合には、
145 jstatd サーバーを実行せずに、
146 jstat および jps ツールをローカルで使用するのが最も安全です。
147 .SH リモートインタフェース
148 .B jstatd
149 プロセスによってエクスポートされるインタフェースはプロプライエタリであり、変更が保証されています。ユーザーおよび開発者は、このインタフェースに書き込まないようにしてください。
150 .SH 使用例
151 .B jstatd
152 の起動例をいくつか示します。これらの
153 .B jstatd
154 スクリプトは、バックグラウンドで自動的にサーバーを起動します。
155 .SS 内部 RMI レジストリの使用
156 この例は、内部 RMI レジストリを使用した
157 .B jstatd
158 の起動を示しています。この例では、他のサーバーがデフォルトの RMI レジストリポート (ポート 1099) にバインドされていないことを前提としています。
159 .LP
160 .RS
161 .ft 3
162 .nf
163 jstatd -J-Djava.security.policy=all.policy
164 .fi
165 .ft 1
166 .RE
167 .SS 外部 RMI レジストリの使用
168 この例は、外部 RMI レジストリを使用した
169 .B jstatd
170 の起動を示しています。
171 .LP
172 .RS
173 .ft 3
174 .nf
175 rmiregistry&
176 jstatd -J-Djava.security.policy=all.policy
177 .fi
178 .ft 1
179 .RE
180 .LP
181 この例は、ポート 2020 上の外部 RMI レジストリサーバーを使用した
182 .B jstatd
183 の起動を示しています。
184 .LP
185 .RS
186 .ft 3
187 .nf
188 rmiregistry 2020&
189 jstatd -J-Djava.security.policy=all.policy -p 2020
190 .fi
191 .ft 1
192 .RE
193 .LP
194 この例は、ポート 2020 上の、AlternateJstatdServerName という名前にバインドされた外部 RMI レジストリを使用した
195 .B jstatd
196 の起動を示しています。
197 .LP
198 .RS
199 .ft 3
200 .nf
201 rmiregistry 2020&
202 jstatd -J-Djava.security.policy=all.policy -p 2020 -n AlternateJstatdServerName
203 .fi
204 .ft 1
205 .RE
206 .SS プロセス内 RMI レジストリの作成の禁止
207 この例は、RMI レジストリが見つからない場合も RMI レジストリを作成しないように
208 .B jstatd
209 を起動する例を示しています。この例では、RMI がすでに実行していることを前提としています。実行していなかった場合は、適切なエラーメッセージが表示されます。
210 .LP
211 .RS
212 .ft 3
213 .nf
214 jstatd -J-Djava.security.policy=all.policy -nr
215 .fi
216 .ft 1
217 .RE
218 .SS RMI ロギング機能の有効化
219 この例は、RMI ロギング機能を有効にして
220 .B jstatd
221 を起動する例を示しています。この方法は、障害追跡やサーバー活動の監視に役立ちます。
222 .LP
223 .RS
224 .ft 3
225 .nf
226 jstatd -J-Djava.security.policy=all.policy -J-Djava.rmi.server.logCalls=true
227 .fi
228 .ft 1
229 .RE
230 .LP
231 .SH 関連項目
232 .LP
233 .RS 3
234 .TP 2
235 *
236 java \- Java アプリケーション起動プログラム
237 .TP 2
238 *
239 jps \- Java 仮想マシンプロセスステータスツール
240 .TP 2
241 *
242 jstat \- Java 仮想マシン統計監視ツール
243 .TP 2
244 *
245 rmiregistry \- Java リモートオブジェクトレジストリ
246 .RE
247
248 .LP
249
250 .LP
251