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