JMX configuration for Tomcat

Window下执行步骤:

D:\apache-tomcat-7.0.57\bin\catalina.bat

set CATALINA_OPTS=-Dcom.sun.management.jmxremote
  -Dcom.sun.management.jmxremote.port=8899
  -Dcom.sun.management.jmxremote.ssl=false
  -Dcom.sun.management.jmxremote.authenticate=true
  -Dcom.sun.management.jmxremote.password.file=../conf/jmxremote.password
  -Dcom.sun.management.jmxremote.access.file=../conf/jmxremote.access

D:\apache-tomcat-7.0.57\conf\jmxremote.access

# Default access control entries:
# o The "monitorRole" role has readonly access.  
# o The "controlRole" role has readwrite access and can create the standard
#   Timer and Monitor MBeans defined by the JMX API.

monitorRole   readonly
controlRole   readwrite \
              create javax.management.monitor.*,javax.management.timer.* \
              unregister

D:\apache-tomcat-7.0.57\conf\jmxremote.password

# In a typical installation, this file can be read by anybody on the
# local machine, and possibly by people on other machines.
# For # security, you should either restrict the access to this file,
# or specify another, less accessible file in the management config file
# as described above.
#
# Following are two commented-out entries. The "measureRole" role has
# password "QED". The "controlRole" role has password "R&D".

monitorRole tomcat
controlRole tomcat

启动Tomcat后,运行如下命令,检测配置效果(注意实际配置的端口号可能不同):

netstat -an | find "8899"

 

参考文章:

中文

  http://blog.csdn.net/caolaosanahnu/article/details/7617211

  http://blog.csdn.net/airobot008/article/details/3951524

StackOverflow

  http://stackoverflow.com/questions/516142/does-java-6-open-a-default-port-for-jmx-remote-connections

Oracle官网及博客

  https://docs.oracle.com/cd/E19340-01/820-6740/ggvud/index.html

  https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html

  https://blogs.oracle.com/jmxetc/entry/connecting_through_firewall_using_jmx

 

Linux下执行步骤:

Additional Implementations
JMX Remote Lifecycle Listener - org.apache.catalina.mbeans.JmxRemoteLifecycleListener

This listener requires catalina-jmx-remote.jar to be placed in $CATALINA_HOME/lib. This jar may be found in the extras directory of the binary download area.

The JMX Remote Lifecycle Listener fixes the ports used by the JMX/RMI Server making things much simpler if you need to connect jconsole or a similar tool to a remote Tomcat instance that is running behind a firewall. Only these ports are configured via the listener. The remainder of the configuration is via the standard system properties for configuring JMX. For further information on configuring JMX see Monitoring and Management Using JMX included with the Java SDK documentation.

This listener must only be nested within a Server element.

The following additional attributes are supported by the JMX Remote Lifecycle Listener:

AttributeDescription
rmiRegistryPortPlatform

The port to be used by the JMX/RMI registry for the Platform MBeans. This replaces the use of the com.sun.management.jmxremote.port system property that should not be set when using this listener.

rmiServerPortPlatform

The port to be used by the Platform JMX/RMI server.

rmiBindAddress

The address of the interface to be used by JMX/RMI server.

useLocalPorts

Should any clients using these ports be forced to use local ports to connect to the JMX/RMI server. This is useful when tunnelling connections over SSH or similar. Defaults to false.

Using file-based Authentication and Authorisation

If this listener was configured in server.xml as:

  <Listener className="org.apache.catalina.mbeans.JmxRemoteLifecycleListener"
          rmiRegistryPortPlatform="10001" rmiServerPortPlatform="10002" />

with the following system properties set (e.g. in setenv.sh):

  -Dcom.sun.management.jmxremote.password.file=$CATALINA_BASE/conf/jmxremote.password
  -Dcom.sun.management.jmxremote.access.file=$CATALINA_BASE/conf/jmxremote.access
  -Dcom.sun.management.jmxremote.ssl=false

$CATALINA_BASE/conf/jmxremote.password containing:

admin letmein

$CATALINA_BASE/conf/jmxremote.access containing:

admin readwrite

then opening ports 10001 (RMI Registry) and 10002 (JMX/RMI Server) in your firewall would enable jconsole to connect to a Tomcat instance running behind a firewall using a connection string of the form:

service:jmx:rmi://<hostname>:10002/jndi/rmi://<hostname>:10001/jmxrmi

with a user name of admin and a password of letmein

1.下载catalina-jmx-remote.jar(支持JMX协议)到tomcat的lib下。

2.配置tomcat的server.xml中的Listener(这样Tomcat收到停止指令时,会通知Listner,不会导致端口被绑定,停不掉的情况)。

3.使用独立的扩展shell(setenv.sh),配置jmx的连接参数。

官方文档出处:

http://tomcat.apache.org/tomcat-7.0-doc/config/listeners.html#JMX_Remote_Lifecycle_Listener_-_org.apache.catalina.mbeans.JmxRemoteLifecycleListener

 

catalina-jmx-remote.jar下载地址:

http://archive.apache.org/dist/tomcat/tomcat-7/v7.0.57/bin/extras/catalina-jmx-remote.jar

http://archive.apache.org/dist/tomcat/tomcat-8/v8.0.28/bin/extras/catalina-jmx-remote.jar

 

三篇考虑比较周全的文章:

https://wiki.scn.sap.com/wiki/pages/viewpage.action?pageId=441453905

https://blog.linuxeye.cn/262.html

https://blog.csdn.net/liuxigiant/article/details/40344699

 

[root@crm_web_dev conf]# cat jmxremote.access
admin
[root@crm_web_dev conf]# cat jmxremote.password
admin
[root@crm_web_dev conf]# vim bin/setenv.sh
[root@crm_web_dev conf]# cd bin
-bash: cd: bin: No such file or directory
[root@crm_web_dev conf]# cd ..
[root@crm_web_dev apache-tomcat-7.0.91]# vim bin/setenv.sh
[root@crm_web_dev apache-tomcat-7.0.91]# cat bin/setenv.sh
CATALINA_OPTS="$CATALINA_OPTS -Djava.rmi.server.hostname=192.168.66.152 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=$CATALINA_HOME/conf/jmxremote.password -Dcom.sun.management.jmxremote.access.file=$CATALINA_HOME/conf/jmxremote.access"
[root@crm_web_dev apache-tomcat-7.0.91]# service tomcat7 restart
Using CATALINA_BASE:   /usr/local/software/tomcat7.0/apache-tomcat-7.0.91
Using CATALINA_HOME:   /usr/local/software/tomcat7.0/apache-tomcat-7.0.91
Using CATALINA_TMPDIR: /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/temp
Using JRE_HOME:        /usr/local/software/jdk1.8/jdk1.8.0_191
Using CLASSPATH:       /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/bootstrap.jar:/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/tomcat-juli.jar
Using CATALINA_BASE:   /usr/local/software/tomcat7.0/apache-tomcat-7.0.91
Using CATALINA_HOME:   /usr/local/software/tomcat7.0/apache-tomcat-7.0.91
Using CATALINA_TMPDIR: /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/temp
Using JRE_HOME:        /usr/local/software/jdk1.8/jdk1.8.0_191
Using CLASSPATH:       /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/bootstrap.jar:/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/tomcat-juli.jar
Tomcat started.
[root@crm_web_dev apache-tomcat-7.0.91]# clear
[root@crm_web_dev apache-tomcat-7.0.91]# cat /etc/hosts
127.0.0.1   crm_web_dev localhost.localdomain localhost4 localhost4.localdomain4
127.0.0.1   localhost
127.0.1.1   crm_web_dev.localdomain crm_web_dev
192.168.66.152 crm_web_dev
192.168.66.152 localhost

::1         crm_web_dev localhost.localdomain localhost6 localhost6.localdomain6
[root@crm_web_dev apache-tomcat-7.0.91]# cat conf/jmxremote.access
admin
[root@crm_web_dev apache-tomcat-7.0.91]# cat conf/jmxremote.password
admin
[root@crm_web_dev apache-tomcat-7.0.91]# chmod +x bin/setenv.sh
[root@crm_web_dev apache-tomcat-7.0.91]# cat bin/setenv.sh CATALINA_OPTS="$CATALINA_OPTS -Djava.rmi.server.hostname=192.168.66.152 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=$CATALINA_HOME/conf/jmxremote.password -Dcom.sun.management.jmxremote.access.file=$CATALINA_HOME/conf/jmxremote.access" [root@crm_web_dev apache-tomcat-7.0.91]# cd #CATALINA_HOME [root@crm_web_dev ~]# cd $CATALINA_HOME [root@crm_web_dev apache-tomcat-7.0.91]# pwd /usr/local/software/tomcat7.0/apache-tomcat-7.0.91 [root@crm_web_dev apache-tomcat-7.0.91]# ps -ef | grep tomcat root 6665 1 1 18:06 pts/0 00:00:04 /usr/local/software/jdk1.8/jdk1.8.0_191/bin/java -Djava.util.logging.config.file=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djdk.tls.ephemeralDHKeySize=2048 -Djava.rmi.server.hostname=192.168.66.152 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/conf/jmxremote.password -Dcom.sun.management.jmxremote.access.file=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/conf/jmxremote.access -Dignore.endorsed.dirs= -classpath /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/bootstrap.jar:/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/bin/tomcat-juli.jar -Dcatalina.base=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91 -Dcatalina.home=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91 -Djava.io.tmpdir=/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/temp org.apache.catalina.startup.Bootstrap start root 6735 6452 0 18:11 pts/0 00:00:00 grep tomcat [root@crm_web_dev apache-tomcat-7.0.91]# netstat -an | grep 10001 tcp 0 0 :::10001 :::* LISTEN [root@crm_web_dev apache-tomcat-7.0.91]# cat conf/server.xml <?xml version='1.0' encoding='utf-8'?> <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> <!-- Note: A "Server" is not itself a "Container", so you may not define subcomponents such as "Valves" at this level. Documentation at /docs/config/server.html --> <Server port="8005" shutdown="SHUTDOWN"> <Listener className="org.apache.catalina.startup.VersionLoggerListener" /> <!-- Security listener. Documentation at /docs/config/listeners.html <Listener className="org.apache.catalina.security.SecurityListener" /> --> <!--APR library loader. Documentation at /docs/apr.html --> <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /> <!--Initialize Jasper prior to webapps are loaded. Documentation at /docs/jasper-howto.html --> <Listener className="org.apache.catalina.core.JasperListener" /> <!-- Prevent memory leaks due to use of particular java/javax APIs--> <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /> <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" /> <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" /> <!-- JMX Remote Lifecycle Listener --> <Listener className="org.apache.catalina.mbeans.JmxRemoteLifecycleListener" rmiRegistryPortPlatform="10001" rmiServerPortPlatform="10002" /> <!-- Global JNDI resources Documentation at /docs/jndi-resources-howto.html --> <GlobalNamingResources> <!-- Editable user database that can also be used by UserDatabaseRealm to authenticate users --> <Resource name="UserDatabase" auth="Container" type="org.apache.catalina.UserDatabase" description="User database that can be updated and saved" factory="org.apache.catalina.users.MemoryUserDatabaseFactory" pathname="conf/tomcat-users.xml" /> </GlobalNamingResources> <!-- A "Service" is a collection of one or more "Connectors" that share a single "Container" Note: A "Service" is not itself a "Container", so you may not define subcomponents such as "Valves" at this level. Documentation at /docs/config/service.html --> <Service name="Catalina"> <!--The connectors can use a shared executor, you can define one or more named thread pools--> <!-- <Executor name="tomcatThreadPool" namePrefix="catalina-exec-" maxThreads="150" minSpareThreads="4"/> --> <!-- A "Connector" represents an endpoint by which requests are received and responses are returned. Documentation at : Java HTTP Connector: /docs/config/http.html (blocking & non-blocking) Java AJP Connector: /docs/config/ajp.html APR (HTTP/AJP) Connector: /docs/apr.html Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> <!-- A "Connector" using the shared thread pool--> <!-- <Connector executor="tomcatThreadPool" port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> --> <!-- Define a SSL HTTP/1.1 Connector on port 8443 This connector uses the BIO implementation that requires the JSSE style configuration. When using the APR/native implementation, the OpenSSL style configuration is required as described in the APR/native documentation --> <!-- <Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol" maxThreads="150" SSLEnabled="true" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" /> --> <!-- Define an AJP 1.3 Connector on port 8009 --> <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> <!-- An Engine represents the entry point (within Catalina) that processes every request. The Engine implementation for Tomcat stand alone analyzes the HTTP headers included with the request, and passes them on to the appropriate Host (virtual host). Documentation at /docs/config/engine.html --> <!-- You should set jvmRoute to support load-balancing via AJP ie : <Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1"> --> <Engine name="Catalina" defaultHost="localhost"> <!--For clustering, please take a look at documentation at: /docs/cluster-howto.html (simple how to) /docs/config/cluster.html (reference documentation) --> <!-- <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/> --> <!-- Use the LockOutRealm to prevent attempts to guess user passwords via a brute-force attack --> <Realm className="org.apache.catalina.realm.LockOutRealm"> <!-- This Realm uses the UserDatabase configured in the global JNDI resources under the key "UserDatabase". Any edits that are performed against this UserDatabase are immediately available for use by the Realm. --> <Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/> </Realm> <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true"> <!-- SingleSignOn valve, share authentication between web applications Documentation at: /docs/config/valve.html --> <!-- <Valve className="org.apache.catalina.authenticator.SingleSignOn" /> --> <!-- Access log processes all example. Documentation at: /docs/config/valve.html Note: The pattern used is equivalent to using pattern="common" --> <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" prefix="localhost_access_log." suffix=".txt" pattern="%h %l %u %t &quot;%r&quot; %s %b" /> </Host> </Engine> </Service> </Server> [root@crm_web_dev apache-tomcat-7.0.91]#

 

scp catalina-jmx-remote.jar 192.168.66.135:/usr/local/software/tomcat7.0/apache-tomcat-7.0.91/lib/

chmod +x /usr/local/software/tomcat7.0/apache-tomcat-7.0.91/lib/catalina-jmx-remote.jar
telnet 192.168.66.152 10001

 

CATALINA_OPTS="$CATALINA_OPTS -Djava.rmi.server.hostname=192.168.66.16 -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.password.file=$CATALINA_HOME/conf/jmxremote.password -Dcom.sun.management.jmxremote.access.file=$CATALINA_HOME/conf/jmxremote.access"

注意:必须配置账号密码,否则可能不行。

 

另一篇用rmi方式访问的例子(配置方式未验证)

https://blog.csdn.net/liuxigiant/article/details/40344699

 

posted @ 2017-02-04 11:04  任国强  阅读(584)  评论(0编辑  收藏  举报