author | goetz |
Thu, 21 Nov 2013 18:29:34 -0800 | |
changeset 22852 | 1063026e8cee |
parent 1447 | 95d5bd511ec2 |
permissions | -rw-r--r-- |
2 | 1 |
##################################################################### |
2 |
# Default Configuration File for Java Platform Management |
|
3 |
##################################################################### |
|
4 |
# |
|
5 |
# The Management Configuration file (in java.util.Properties format) |
|
6 |
# will be read if one of the following system properties is set: |
|
7 |
# -Dcom.sun.management.jmxremote.port=<port-number> |
|
8 |
# or -Dcom.sun.management.snmp.port=<port-number> |
|
9 |
# or -Dcom.sun.management.config.file=<this-file> |
|
10 |
# |
|
11 |
# The default Management Configuration file is: |
|
12 |
# |
|
13 |
# $JRE/lib/management/management.properties |
|
14 |
# |
|
15 |
# Another location for the Management Configuration File can be specified |
|
16 |
# by the following property on the Java command line: |
|
17 |
# |
|
18 |
# -Dcom.sun.management.config.file=<this-file> |
|
19 |
# |
|
20 |
# If -Dcom.sun.management.config.file=<this-file> is set, the port |
|
21 |
# number for the management agent can be specified in the config file |
|
22 |
# using the following lines: |
|
23 |
# |
|
24 |
# ################ Management Agent Port ######################### |
|
25 |
# |
|
26 |
# For setting the JMX RMI agent port use the following line |
|
27 |
# com.sun.management.jmxremote.port=<port-number> |
|
28 |
# |
|
29 |
# For setting the SNMP agent port use the following line |
|
30 |
# com.sun.management.snmp.port=<port-number> |
|
31 |
||
32 |
##################################################################### |
|
33 |
# Optional Instrumentation |
|
34 |
##################################################################### |
|
35 |
# |
|
36 |
# By default only the basic instrumentation with low overhead is on. |
|
37 |
# The following properties allow to selectively turn on optional |
|
38 |
# instrumentation which are off by default and may have some |
|
39 |
# additional overhead. |
|
40 |
# |
|
41 |
# com.sun.management.enableThreadContentionMonitoring |
|
42 |
# |
|
43 |
# This option enables thread contention monitoring if the |
|
44 |
# Java virtual machine supports such instrumentation. |
|
45 |
# Refer to the specification for the java.lang.management.ThreadMBean |
|
46 |
# interface - see isThreadContentionMonitoringSupported() method. |
|
47 |
# |
|
48 |
||
49 |
# To enable thread contention monitoring, uncomment the following line |
|
50 |
# com.sun.management.enableThreadContentionMonitoring |
|
51 |
||
52 |
##################################################################### |
|
53 |
# SNMP Management Properties |
|
54 |
##################################################################### |
|
55 |
# |
|
56 |
# If the system property -Dcom.sun.management.snmp.port=<port-number> |
|
57 |
# is set then |
|
58 |
# - The SNMP agent (with the Java virtual machine MIB) is started |
|
59 |
# that listens on the specified port for incoming SNMP requests. |
|
60 |
# - the following properties for read for SNMP management. |
|
61 |
# |
|
62 |
# The configuration can be specified only at startup time. |
|
63 |
# Later changes to the above system property (e.g. via setProperty method), this |
|
64 |
# config file, or the ACL file has no effect to the running SNMP agent. |
|
65 |
# |
|
66 |
||
67 |
# |
|
68 |
# ##################### SNMP Trap Port ######################### |
|
69 |
# |
|
70 |
# com.sun.management.snmp.trap=<trap-destination-port-number> |
|
71 |
# Specifies the remote port number at which managers are expected |
|
72 |
# to listen for trap. For each host defined in the ACL file, |
|
73 |
# the SNMP agent will send traps at <host>:<trap-destination-port-number> |
|
74 |
# Default for this property is 162. |
|
75 |
# |
|
76 |
||
77 |
# To set port for sending traps to a different port use the following line |
|
78 |
# com.sun.management.snmp.trap=<trap-destination-port-number> |
|
79 |
||
80 |
# |
|
81 |
# ################ SNMP listen interface ######################### |
|
82 |
# |
|
83 |
# com.sun.management.snmp.interface=<InetAddress> |
|
84 |
# Specifies the local interface on which the SNMP agent will bind. |
|
1447
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
85 |
# This is useful when running on machines which have several |
2 | 86 |
# interfaces defined. It makes it possible to listen to a specific |
87 |
# subnet accessible through that interface. |
|
88 |
# Default for this property is "localhost". |
|
89 |
# |
|
90 |
# The format of the value for that property is any string accepted |
|
91 |
# by java.net.InetAddress.getByName(String). |
|
92 |
# |
|
93 |
||
94 |
# For restricting the port on which SNMP agent listens use the following line |
|
95 |
# com.sun.management.snmp.interface=<InetAddress> |
|
96 |
||
97 |
# |
|
98 |
# #################### SNMP ACL file ######################### |
|
99 |
# |
|
100 |
# com.sun.management.snmp.acl=true|false |
|
101 |
# Default for this property is true. (Case for true/false ignored) |
|
102 |
# If this property is specified as false then the ACL file |
|
103 |
# is not checked: all manager hosts are allowed all access. |
|
104 |
# |
|
105 |
||
106 |
# For SNMP without checking ACL file uncomment the following line |
|
107 |
# com.sun.management.snmp.acl=false |
|
108 |
||
109 |
# |
|
110 |
# com.sun.management.snmp.acl.file=filepath |
|
111 |
# Specifies location for ACL file |
|
112 |
# This is optional - default location is |
|
113 |
# $JRE/lib/management/snmp.acl |
|
114 |
# |
|
115 |
# If the property "com.sun.management.snmp.acl" is set to false, |
|
116 |
# then this property and the ACL file are ignored. |
|
117 |
# Otherwise the ACL file must exist and be in the valid format. |
|
118 |
# If the ACL file is empty or non existent then no access is allowed. |
|
119 |
# |
|
120 |
# The SNMP agent will read the ACL file at startup time. |
|
121 |
# Modification to the ACL file has no effect to any running SNMP |
|
122 |
# agents which read that ACL file at startup. |
|
123 |
# |
|
124 |
||
125 |
# For a non-default acl file location use the following line |
|
126 |
# com.sun.management.snmp.acl.file=filepath |
|
127 |
||
128 |
##################################################################### |
|
129 |
# RMI Management Properties |
|
130 |
##################################################################### |
|
131 |
# |
|
132 |
# If system property -Dcom.sun.management.jmxremote.port=<port-number> |
|
133 |
# is set then |
|
134 |
# - A MBean server is started |
|
135 |
# - JRE Platform MBeans are registered in the MBean server |
|
136 |
# - RMI connector is published in a private readonly registry at |
|
137 |
# specified port using a well known name, "jmxrmi" |
|
138 |
# - the following properties are read for JMX remote management. |
|
139 |
# |
|
140 |
# The configuration can be specified only at startup time. |
|
141 |
# Later changes to above system property (e.g. via setProperty method), |
|
142 |
# this config file, the password file, or the access file have no effect to the |
|
143 |
# running MBean server, the connector, or the registry. |
|
144 |
# |
|
145 |
||
146 |
# |
|
1447
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
147 |
# ########## RMI connector settings for local management ########## |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
148 |
# |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
149 |
# com.sun.management.jmxremote.local.only=true|false |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
150 |
# Default for this property is true. (Case for true/false ignored) |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
151 |
# If this property is specified as true then the local JMX RMI connector |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
152 |
# server will only accept connection requests from clients running on |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
153 |
# the host where the out-of-the-box JMX management agent is running. |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
154 |
# In order to ensure backwards compatibility this property could be |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
155 |
# set to false. However, deploying the local management agent in this |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
156 |
# way is discouraged because the local JMX RMI connector server will |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
157 |
# accept connection requests from any client either local or remote. |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
158 |
# For remote management the remote JMX RMI connector server should |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
159 |
# be used instead with authentication and SSL/TLS encryption enabled. |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
160 |
# |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
161 |
|
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
162 |
# For allowing the local management agent accept local |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
163 |
# and remote connection requests use the following line |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
164 |
# com.sun.management.jmxremote.local.only=false |
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
165 |
|
95d5bd511ec2
6332953: JMX agent should bind to loopback address when starting the local connector server
dfuchs
parents:
2
diff
changeset
|
166 |
# |
2 | 167 |
# ###################### RMI SSL ############################# |
168 |
# |
|
169 |
# com.sun.management.jmxremote.ssl=true|false |
|
170 |
# Default for this property is true. (Case for true/false ignored) |
|
171 |
# If this property is specified as false then SSL is not used. |
|
172 |
# |
|
173 |
||
174 |
# For RMI monitoring without SSL use the following line |
|
175 |
# com.sun.management.jmxremote.ssl=false |
|
176 |
||
177 |
# com.sun.management.jmxremote.ssl.config.file=filepath |
|
178 |
# Specifies the location of the SSL configuration file. A properties |
|
179 |
# file can be used to supply the keystore and truststore location and |
|
180 |
# password settings thus avoiding to pass them as cleartext in the |
|
181 |
# command-line. |
|
182 |
# |
|
183 |
# The current implementation of the out-of-the-box management agent will |
|
184 |
# look up and use the properties specified below to configure the SSL |
|
185 |
# keystore and truststore, if present: |
|
186 |
# javax.net.ssl.keyStore=<keystore-location> |
|
187 |
# javax.net.ssl.keyStorePassword=<keystore-password> |
|
188 |
# javax.net.ssl.trustStore=<truststore-location> |
|
189 |
# javax.net.ssl.trustStorePassword=<truststore-password> |
|
190 |
# Any other properties in the file will be ignored. This will allow us |
|
191 |
# to extend the property set in the future if required by the default |
|
192 |
# SSL implementation. |
|
193 |
# |
|
194 |
# If the property "com.sun.management.jmxremote.ssl" is set to false, |
|
195 |
# then this property is ignored. |
|
196 |
# |
|
197 |
||
198 |
# For supplying the keystore settings in a file use the following line |
|
199 |
# com.sun.management.jmxremote.ssl.config.file=filepath |
|
200 |
||
201 |
# com.sun.management.jmxremote.ssl.enabled.cipher.suites=<cipher-suites> |
|
202 |
# The value of this property is a string that is a comma-separated list |
|
203 |
# of SSL/TLS cipher suites to enable. This property can be specified in |
|
204 |
# conjunction with the previous property "com.sun.management.jmxremote.ssl" |
|
205 |
# in order to control which particular SSL/TLS cipher suites are enabled |
|
206 |
# for use by accepted connections. If this property is not specified then |
|
207 |
# the SSL/TLS RMI Server Socket Factory uses the SSL/TLS cipher suites that |
|
208 |
# are enabled by default. |
|
209 |
# |
|
210 |
||
211 |
# com.sun.management.jmxremote.ssl.enabled.protocols=<protocol-versions> |
|
212 |
# The value of this property is a string that is a comma-separated list |
|
213 |
# of SSL/TLS protocol versions to enable. This property can be specified in |
|
214 |
# conjunction with the previous property "com.sun.management.jmxremote.ssl" |
|
215 |
# in order to control which particular SSL/TLS protocol versions are |
|
216 |
# enabled for use by accepted connections. If this property is not |
|
217 |
# specified then the SSL/TLS RMI Server Socket Factory uses the SSL/TLS |
|
218 |
# protocol versions that are enabled by default. |
|
219 |
# |
|
220 |
||
221 |
# com.sun.management.jmxremote.ssl.need.client.auth=true|false |
|
222 |
# Default for this property is false. (Case for true/false ignored) |
|
223 |
# If this property is specified as true in conjunction with the previous |
|
224 |
# property "com.sun.management.jmxremote.ssl" then the SSL/TLS RMI Server |
|
225 |
# Socket Factory will require client authentication. |
|
226 |
# |
|
227 |
||
228 |
# For RMI monitoring with SSL client authentication use the following line |
|
229 |
# com.sun.management.jmxremote.ssl.need.client.auth=true |
|
230 |
||
231 |
# com.sun.management.jmxremote.registry.ssl=true|false |
|
232 |
# Default for this property is false. (Case for true/false ignored) |
|
233 |
# If this property is specified as true then the RMI registry used |
|
234 |
# to bind the RMIServer remote object is protected with SSL/TLS |
|
235 |
# RMI Socket Factories that can be configured with the properties: |
|
236 |
# com.sun.management.jmxremote.ssl.config.file |
|
237 |
# com.sun.management.jmxremote.ssl.enabled.cipher.suites |
|
238 |
# com.sun.management.jmxremote.ssl.enabled.protocols |
|
239 |
# com.sun.management.jmxremote.ssl.need.client.auth |
|
240 |
# If the two properties below are true at the same time, i.e. |
|
241 |
# com.sun.management.jmxremote.ssl=true |
|
242 |
# com.sun.management.jmxremote.registry.ssl=true |
|
243 |
# then the RMIServer remote object and the RMI registry are |
|
244 |
# both exported with the same SSL/TLS RMI Socket Factories. |
|
245 |
# |
|
246 |
||
247 |
# For using an SSL/TLS protected RMI registry use the following line |
|
248 |
# com.sun.management.jmxremote.registry.ssl=true |
|
249 |
||
250 |
# |
|
251 |
# ################ RMI User authentication ################ |
|
252 |
# |
|
253 |
# com.sun.management.jmxremote.authenticate=true|false |
|
254 |
# Default for this property is true. (Case for true/false ignored) |
|
255 |
# If this property is specified as false then no authentication is |
|
256 |
# performed and all users are allowed all access. |
|
257 |
# |
|
258 |
||
259 |
# For RMI monitoring without any checking use the following line |
|
260 |
# com.sun.management.jmxremote.authenticate=false |
|
261 |
||
262 |
# |
|
263 |
# ################ RMI Login configuration ################### |
|
264 |
# |
|
265 |
# com.sun.management.jmxremote.login.config=<config-name> |
|
266 |
# Specifies the name of a JAAS login configuration entry to use when |
|
267 |
# authenticating users of RMI monitoring. |
|
268 |
# |
|
269 |
# Setting this property is optional - the default login configuration |
|
270 |
# specifies a file-based authentication that uses the password file. |
|
271 |
# |
|
272 |
# When using this property to override the default login configuration |
|
273 |
# then the named configuration entry must be in a file that gets loaded |
|
274 |
# by JAAS. In addition, the login module(s) specified in the configuration |
|
275 |
# should use the name and/or password callbacks to acquire the user's |
|
276 |
# credentials. See the NameCallback and PasswordCallback classes in the |
|
277 |
# javax.security.auth.callback package for more details. |
|
278 |
# |
|
279 |
# If the property "com.sun.management.jmxremote.authenticate" is set to |
|
280 |
# false, then this property and the password & access files are ignored. |
|
281 |
# |
|
282 |
||
283 |
# For a non-default login configuration use the following line |
|
284 |
# com.sun.management.jmxremote.login.config=<config-name> |
|
285 |
||
286 |
# |
|
287 |
# ################ RMI Password file location ################## |
|
288 |
# |
|
289 |
# com.sun.management.jmxremote.password.file=filepath |
|
290 |
# Specifies location for password file |
|
291 |
# This is optional - default location is |
|
292 |
# $JRE/lib/management/jmxremote.password |
|
293 |
# |
|
294 |
# If the property "com.sun.management.jmxremote.authenticate" is set to |
|
295 |
# false, then this property and the password & access files are ignored. |
|
296 |
# Otherwise the password file must exist and be in the valid format. |
|
297 |
# If the password file is empty or non-existent then no access is allowed. |
|
298 |
# |
|
299 |
||
300 |
# For a non-default password file location use the following line |
|
301 |
# com.sun.management.jmxremote.password.file=filepath |
|
302 |
||
303 |
# |
|
304 |
# ################ RMI Access file location ##################### |
|
305 |
# |
|
306 |
# com.sun.management.jmxremote.access.file=filepath |
|
307 |
# Specifies location for access file |
|
308 |
# This is optional - default location is |
|
309 |
# $JRE/lib/management/jmxremote.access |
|
310 |
# |
|
311 |
# If the property "com.sun.management.jmxremote.authenticate" is set to |
|
312 |
# false, then this property and the password & access files are ignored. |
|
313 |
# Otherwise, the access file must exist and be in the valid format. |
|
314 |
# If the access file is empty or non-existent then no access is allowed. |
|
315 |
# |
|
316 |
||
317 |
# For a non-default password file location use the following line |
|
318 |
# com.sun.management.jmxremote.access.file=filepath |