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