| 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. | 
|---|
| 85 | #      This is useful when running on machines which have several | 
|---|
| 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 | # | 
|---|
| 147 | # ########## RMI connector settings for local management ########## | 
|---|
| 148 | # | 
|---|
| 149 | # com.sun.management.jmxremote.local.only=true|false | 
|---|
| 150 | #      Default for this property is true. (Case for true/false ignored) | 
|---|
| 151 | #      If this property is specified as true then the local JMX RMI connector | 
|---|
| 152 | #      server will only accept connection requests from clients running on | 
|---|
| 153 | #      the host where the out-of-the-box JMX management agent is running. | 
|---|
| 154 | #      In order to ensure backwards compatibility this property could be | 
|---|
| 155 | #      set to false. However, deploying the local management agent in this | 
|---|
| 156 | #      way is discouraged because the local JMX RMI connector server will | 
|---|
| 157 | #      accept connection requests from any client either local or remote. | 
|---|
| 158 | #      For remote management the remote JMX RMI connector server should | 
|---|
| 159 | #      be used instead with authentication and SSL/TLS encryption enabled. | 
|---|
| 160 | # | 
|---|
| 161 |  | 
|---|
| 162 | # For allowing the local management agent accept local | 
|---|
| 163 | # and remote connection requests use the following line | 
|---|
| 164 | # com.sun.management.jmxremote.local.only=false | 
|---|
| 165 |  | 
|---|
| 166 | # | 
|---|
| 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 | 
|---|