Name

jstatd — jstat daemon

Synopsis

jstatd options
               

Description

jstatd is a server that provides information about local Java processes to the jps and jstat programs running on remote hosts.

jstatd uses RMI and requires special security permissions to run successfully. To start jstatd, create the following file and name it jstatd.policy:

grant codebase "file:${java.home}../lib/tools.jar {
    permission java.security.AllPermission
}

This policy grants all permissions to any class loaded from the JDK’s tools.jar JAR file. To launch jstatd with this policy, use this command line:

% jstatd -J-Djava.security.policy=jstat.policy
               

If an existing rmiregistry server is running, jstatd uses it. Otherwise, it creates its own RMI registry.

Options

-n rminame

Binds the jstatd remote object to the name rminame in the RMI registry. The default name is “JStatRemoteHost”, which is what jps and jstat look for. Use of this option requires rminame to be used in remote jps and jstat invocations.

-nr

Tells jstatd that not to start an internal RMI registry if none are already running.

-p port

Looks for an existing RMI registry on port, or starts one on that port if no existing registry is found.

See also

jps, jstat

Get Java in a Nutshell, 5th Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.