By default these commands are disabled. Enabling the command requires ManagerService
be registered in resin.xml file.
<resin xmlns="http://caucho.com/ns/resin"
xmlns:resin="urn:java:com.caucho.resin"
xmlns:sec="urn:java:com.caucho.security">
...
<cluster id=''>
<sec:AdminAuthenticator password-digest="none">
<sec:user name="admin" password="secret"/>
</sec:AdminAuthenticator>
<resin:RemoteAdminService/>
<resin:ManagerService/>
...
</cluster>
...
</resin>
| Command |
Description |
| heap-dump |
produces heap dump |
| thread-dump |
produces thread dump |
| profile |
turn profiling and displays results after sampling completes |
| jmx-list |
lists MBeans, attributes and operations |
| jmx-set |
sets value of a jmx attribute |
| jmx-call |
calls MBean's method |
| log-level |
changes log-level |
Since all commands require connecting to Resin server remotely list of
required parameters includes authentication and remote connection options
such as IP and Port.
| Argument |
Meaning |
Default |
| -conf |
configuration file |
conf/resin.xml |
| -address |
ip or host name of the server |
taken from conf/resin.xml |
| -port |
server http port |
taken from conf/resin.xml |
| -user |
user name used for authentication to the server |
none, required |
| -password |
password used for authentication to the server |
none, required |
To produce a heap dump resin provides heap-dump command. With
Resin Open Source, heap-dump will produce a standard heap dump
file and put it into a temporary directory on a remote machine.
java -jar resin.jar [-conf <file>] heap-dump -user <user> -password <password> [-raw]
$java -jar lib/resin.jar -conf conf/resin.conf heap-dump -user foo -password test -raw
Heap dump is written to `/tmp/hprof-default-2011-04-08-02-51-31.hprof'.
To view the file on the target machine use
jvisualvm --openfile /tmp/hprof-default-2011-04-08-02-51-31.hprof
Resin Pro, when heap-dump is given no -raw option is capable of
producing a readable summary report.
$java -jar lib/resin.jar -conf conf/resin.conf heap-dump -user foo -password test
Heap Dump generated Fri May 08 02:51:31 PDT 1998
count | self size | child size | class name
68 | 6528 | 3142736 | com.caucho.util.LruCache
28768 | 920576 | 2674000 | java.lang.String
29403 | 2066488 | 2066488 | char[]
68 | 1927360 | 1927360 | com.caucho.util.LruCache$CacheItem[]
7346 | 715416 | 1796320 | java.lang.Object[]
5710 | 594200 | 1768624 | java.util.HashMap$Entry[]
2827 | 135696 | 1606264 | java.util.HashMap
20787 | 665184 | 1489024 | java.util.HashMap$Entry
9682 | 852016 | 1235984 | java.lang.reflect.Method
61507 | 984112 | 984400 | java.lang.Object
337 | 16176 | 889192 | java.util.concurrent.ConcurrentHashMap
2881 | 161336 | 883584 | java.util.LinkedHashMap
1596 | 178752 | 702296 | com.caucho.quercus.program.ProStaticFunction
| Argument/Option |
Meaning |
Default |
| -raw |
produces a standard .hprof file |
|
since raw heap dump can be on the order of gigabytes the resulting file
is always left on the machine where Resin server is running.
To produce a thread dump resin provides thread-dump command.
The thread dump is produced on a remote sever and printed out locally.
java -jar resin.jar [-conf <file>] thread-dump -user <user> -password <password> [-raw]
$java -jar lib/resin.jar -conf conf/resin.conf thread-dump -user foo -password test -raw
Thread Dump:
"MailboxWorker[manager@resin.caucho]-8" id=31 RUNNABLE
at sun.management.ThreadImpl.getThreadInfo0 (ThreadImpl.java) (native)
at sun.management.ThreadImpl.getThreadInfo (ThreadImpl.java:147)
at com.caucho.util.ThreadDump.threadDumpImpl (ThreadDump.java:88)
at com.caucho.util.ThreadDump.getThreadDump (ThreadDump.java:62)
at com.caucho.server.admin.ManagerActor.doThreadDump (ManagerActor.java:148)
at sun.reflect.NativeMethodAccessorImpl.invoke0 (NativeMethodAccessorImpl.java) (native)
at sun.reflect.NativeMethodAccessorImpl.invoke (NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke (DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke (Method.java:597)
at com.caucho.bam.actor.BamSkeleton$QueryMethodInvoker.invoke (BamSkeleton.java:501)
at com.caucho.bam.actor.BamSkeleton.query (BamSkeleton.java:215)
at com.caucho.bam.actor.SkeletonActorFilter.query (SkeletonActorFilter.java:187)
at com.caucho.bam.query.QueryActorFilter.query (QueryActorFilter.java:95)
at com.caucho.bam.packet.Query.dispatch (Query.java:86)
at com.caucho.bam.mailbox.MultiworkerMailbox.dispatch (MultiworkerMailbox.java:268)
at com.caucho.bam.mailbox.MailboxWorker.runTask (MailboxWorker.java:73)
at com.caucho.env.thread.AbstractTaskWorker.run (AbstractTaskWorker.java:160)
at com.caucho.env.thread.ResinThread.runTasks (ResinThread.java:164)
at com.caucho.env.thread.ResinThread.run (ResinThread.java:130)
"Signal Dispatcher" id=5 RUNNABLE
"http://*:8087-1" id=26 RUNNABLE (in native)
at com.caucho.vfs.JniSocketImpl.readNative (JniSocketImpl.java) (native)
at com.caucho.vfs.JniSocketImpl.read (JniSocketImpl.java:337)
at com.caucho.vfs.JniStream.readTimeout (JniStream.java:90)
at com.caucho.vfs.ReadStream.fillWithTimeout (ReadStream.java:1135)
at com.caucho.network.listen.TcpSocketLinkListener.keepaliveThreadRead (TcpSocketLinkListener.java:1345)
at com.caucho.network.listen.TcpSocketLink.processKeepalive (TcpSocketLink.java:767)
at com.caucho.network.listen.DuplexReadTask.doTask (DuplexReadTask.java:91)
at com.caucho.network.listen.TcpSocketLink.handleRequests (TcpSocketLink.java:646)
at com.caucho.network.listen.AcceptTask.doTask (AcceptTask.java:104)
at com.caucho.network.listen.ConnectionReadTask.runThread (ConnectionReadTask.java:98)
at com.caucho.network.listen.ConnectionReadTask.run (ConnectionReadTask.java:81)
at com.caucho.network.listen.AcceptTask.run (AcceptTask.java:67)
at com.caucho.env.thread.ResinThread.runTasks (ResinThread.java:164)
at com.caucho.env.thread.ResinThread.run (ResinThread.java:130)
...
Profiling application can help find bottlenecks. Resin's
profile
command turn on sampling for requested period of time and prints out
profiling resutls.
java -jar resin.jar [-conf <file>] profile -user <user> -password <password> [-active-time <time>] [-sampling-rate <rate>] [-depth <depth>]
$java -jar lib/resin.jar -conf conf/resin.conf profile -user foo -password test
Profile started at 1998-05-08 02:51:31.001. Active for a total of 5000ms. Sampling rate 10ms. Depth 16.
% time |time self(s)| % sum | Method Call
800.000 | 40.080 | 28.407 | com.caucho.env.thread.AbstractTaskWorker.run()
300.000 | 15.030 | 39.060 | com.caucho.env.thread.ResinThread.waitForTask()
200.000 | 10.020 | 46.162 | com.caucho.vfs.JniSocketImpl.nativeAccept()
116.168 | 5.820 | 50.287 | _jsp._test__jsp$1.run()
100.000 | 5.010 | 53.838 | com.caucho.env.thread.AbstractTaskWorker.run()
100.000 | 5.010 | 57.389 | java.lang.ref.ReferenceQueue.remove()
100.000 | 5.010 | 60.940 | com.caucho.server.admin.ManagerActor.profile()
100.000 | 5.010 | 64.491 | java.lang.ref.Reference$ReferenceHandler.run()
100.000 | 5.010 | 68.042 | java.lang.UNIXProcess.waitForProcessExit()
100.000 | 5.010 | 71.593 | java.io.FileInputStream.readBytes()
100.000 | 5.010 | 75.144 | com.caucho.util.Alarm$AlarmThread.run()
100.000 | 5.010 | 78.694 | com.caucho.env.shutdown.ShutdownSystem$ShutdownThread.run()
100.000 | 5.010 | 82.245 | com.caucho.network.listen.JniSelectManager.selectNative()
100.000 | 5.010 | 85.796 | unknown
100.000 | 5.010 | 89.347 | com.caucho.vfs.JniSocketImpl.readNative()
100.000 | 5.010 | 92.898 | com.caucho.test.Test$Timeout.run()
100.000 | 5.010 | 96.449 | com.caucho.profile.ProProfile.nativeProfile()
100.000 | 5.010 | 100.000 | java.lang.Thread.sleep()
com.caucho.env.thread.AbstractTaskWorker.run()
sun.misc.Unsafe.park()
java.util.concurrent.locks.LockSupport.parkUntil()
com.caucho.env.thread.AbstractTaskWorker.run()
com.caucho.env.thread.ResinThread.runTasks()
com.caucho.env.thread.ResinThread.run()
| Argument/Option |
Meaning |
Default |
| -active-time |
specifies profiling time span in ms (defaults to 5000 - 5 sec.) |
5s |
| -sampling-rate |
specifies sampling rate (defaults to 10ms) |
10ms |
Command log-level allows to temporarily increase log level
for an application.
java -jar resin.jar [-conf <file>] log-level -user <user> -password <password> [-active-time <time-period>] [-log-name <name>] <level>
$java -jar lib/resin.jar -conf conf/resin.conf log-level -user foo -password test -active-time 5s finer
Log {root}.level is set to `FINER'. Active time 5 seconds.
| Argument/Option |
Meaning |
Default |
| -active-time |
specifies new level active time (default 60s). e.g. 5s |
60s |
| -log-name |
specifies name of the logger. Defaults to root logger. |
root logger |
| value |
specifies new log level (finest, finer, fine) |
none, required |
Commandjmx-list prints out JMX MBeans, attributes and operations
registered in a JVM that is running Resin. As its last argument the command
accepts <pattern>. The <pattern> follows convention defined for
javax.management.ObjectName, defaulting to resin:*, which matches any
MBean in resin domain.
java -jar lib/resin.jar [-conf <file>] jmx-list -user <user> -password <password> [-attributes] [-values] [-operations] [-all] [-platform] [<pattern>]
$java -jar lib/resin.jar -conf conf/resin.conf jmx-list -user foo -password test com.acme:*
com.acme:type=Foo
com.acme:type=Bar
| Argument/Option |
Meaning |
| -attributes |
outputs a list of attributes for each MBean |
| -values |
outputs a list of attributes and values for each MBean |
| -operations |
outputs a list of operations each MBean |
| -operations |
outputs a list of operations each MBean |
| -platform |
only queries MBeans in java.lang domain(unless pattern is specified) |
| -all |
queries MBeans in any domain(unless pattern is specified) |
$java -jar lib/resin.jar -conf conf/resin.conf jmx-list -user foo -password test -values com.acme:*
com.acme:type=Foo
attributes:
javax.management.MBeanAttributeInfo[description=, name=Boolean, type=boolean, read-only, descriptor={}]==false
Commandjmx-set sets a value on an attribute belonging to a particular
JMX MBean.
java -jar lib/resin.jar [-conf <file>] jmx-set -user <user> -password <password> -pattern <pattern> -attribute <attribute> value
$java -jar lib/resin.jar -conf conf/resin.conf jmx-set -user foo -password test -pattern com.acme:type=Foo -attribute Foo foo-value
value for attribute `Foo' on bean `com.acme:type=Foo' is changed from `null' to `foo-value'
| Argument/Option |
Meaning |
| -pattern |
specifies pattern to match target MBean |
| -attribute |
sets name of the attribute |
| value |
String representation of the value (primitive types and String are
supported)
|
Commandjmx-call calls a method on a specified with < pattern> MBean.
java -jar resin.jar [-conf <file>] jmx-call -user <user> -password <password> -pattern <pattern> -operation <operation> value...
$java -jar lib/resin.jar -conf conf/resin.conf jmx-call -user foo -password test -pattern com.acme:type=Foo -pattern com.acme:type=Foo -operation echo hello
method `echo(java.lang.String)' called on `com.acme:type=Foo' returned `hello'.
| Argument/Option |
Meaning |
| -pattern |
specifies pattern to match target MBean |
| -operation |
sets name of the operation to invoke |
| value |
space separated list of parameters that will be passed to the method (primitive types and String are
supported)
|