j4psh - A JMX Shell


  j4psh [options] <server>

  j4psh --help

  j4psh --version

   --user <user>           Credential used for authentication   
   --password <pwd>  
   --proxy <url>           URL to use as proxy proxy
   --proxy-user <user>     Authentication information for a proxy
   --proxy-password <pwd>
   --target <jmx-url>      JSR-160 JMX Service URL to be used as the target server
   --target-user <user>    Credential for the target server if --target is given
   --target-password <pwd> 
   --option key=val        Options for tuning the output of jmx4perl. Known keys are
                              format   : Either 'json' or 'data'
                              booleans : Pair of strings separated by slash to use for printing 
                                         boolean values (Default: [true]/[false])
                              indent   : Space indent when printing complex data structures 
   --config <cfg>          Path to an optional configuration file (default: ~/.j4p). Can be a directory
                           in which case <dir>/jmx4perl.cfg is used.
   --color [yes|no]        Color option (default: yes)

An optional argument can be used to directly connect to an agent URL or symbolic name as defined in the configuration file. If not given, the shell does no initial connect.


j4psh is a frontend to JMX::Jmx4Perl providing an interactive shell for accessing JMX MBeans on a remote Java server.

  • Readline and history support based on GNU Readline/History as known from other shells like 'bash'. When GNU Readline is not available, a pure Perl Module is used instead.

  • Context sensitive argument completion, e.g. on MBean names and attributes.

  • Colored output (can be switched off)

  • Multi-Server support

  • Remote operation via HTTP(S)


This file is part of jmx4perl.

Jmx4perl is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

jmx4perl is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with jmx4perl. If not, see <>.

A commercial license is available as well. Please contact for further details.


Just in case you need professional support for this module (or Nagios or JMX in general), you might want to have a look at Contact for further information (or use the contact form at