JMX::Jmx4Perl::Config - Configuration file support for Jmx4Perl


Configuration file format
  # ================================================================
  # Sample configuration for jmx4perl

  # localhost is the name how this config could accessed
  <Server localhost>
    # Options for JMX::Jmx4Perl->new, case is irrelevant
    Url  = http://localhost:8080/j4p
    User = roland
    Password = test
    Product = JBoss

    # HTTP proxy for accessing the agent
      Url = http://proxy:8001
      User = proxyuser
      Password = ppaasswwdd
    # Target for running j4p in proxy mode
      Url       service:jmx:iiop://....
      User      weblogic
      Password  weblogic
  my $config = new JMX::Jmx4Perl::Config($config_file);



$cfg = JMX::Jmx4Perl::Config->new($file_or_hash)

Create a new configuration object with the given file name. If no file name is given the configuration ~/.j4p is tried. In case the given file is a directory, a file dir/jxm4perl.cfg is tried as configuration file.

If the file does not exist, server_config_exists will alway return false and get_server_config will always return undef

If a hash is given as argument, this hash is used to extract the server information.

$exists = $config->server_config_exists($name)

Check whether a configuration entry for the server with name $name exist.

$server_config = $config->get_server_config($name)

Get the configuration for the given server or undef if no such configuration exist.

$servers = $config->get_servers

Get an arrayref to all configured servers or an empty arrayref.


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