NAME

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

SYNOPSIS

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
  <Proxy>
    Url = http://proxy:8001
    User = proxyuser
    Password = ppaasswwdd
  </Proxy>
  # Target for running j4p in proxy mode
  <Target>
    Url       service:jmx:iiop://....
    User      weblogic
    Password  weblogic
  </Target>       
</Server>

Usage

my $config = new JMX::Jmx4Perl::Config($config_file);

DESCRIPTION

METHODS

$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.

LICENSE

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 <http://www.gnu.org/licenses/>.

A commercial license is available as well. Please contact roland@cpan.org for further details.

PROFESSIONAL SERVICES

Just in case you need professional support for this module (or Nagios or JMX in general), you might want to have a look at http://www.consol.com/opensource/nagios/. Contact roland.huss@consol.de for further information (or use the contact form at http://www.consol.com/contact/)

AUTHOR

roland@cpan.org