mars 2.2.7 user’s guideleapfrog-mars. 2.2.7 user’s guide ... a.11 mars 2.1.1 – june 30, ......

Download Mars 2.2.7 User’s Guideleapfrog-mars.  2.2.7 User’s Guide ... A.11 Mars 2.1.1 – June 30, ... Timeout is the time, in seconds, Mars will wait for a service to respond before

Post on 21-Apr-2018

215 views

Category:

Documents

3 download

Embed Size (px)

TRANSCRIPT

  • Mars 2.2.7 Users Guide

    Brian Trammellbrian@lfrd.com

    Leapfrog Research and Development, LLC

    March 22, 2004

    Abstract

    Describes the Mars network status monitor, and walks a new userthrough installation, configuration, and use.

    Contents

    1 About Mars 2

    2 The Mars Distribution 2

    3 Installing Mars 33.1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . 33.2 Distribution Contents . . . . . . . . . . . . . . . . . . . . . . . . 3

    4 Starting Mars 4

    5 Adding Hosts and Services 55.1 The Host Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . 55.2 The Service Editor . . . . . . . . . . . . . . . . . . . . . . . . . . 65.3 Keyboard Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

    6 Monitoring Services with Mars 8

    7 Plugins and Probe Extensions 117.1 UI Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117.2 Mail Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . 127.3 CSV Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127.4 XML Snapshot . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137.5 XMPP Notification . . . . . . . . . . . . . . . . . . . . . . . . . . 137.6 Client Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . 147.7 Mac OS X Integration . . . . . . . . . . . . . . . . . . . . . . . . 147.8 HTTPS Probe Extension . . . . . . . . . . . . . . . . . . . . . . 147.9 JDBC Probe Extension . . . . . . . . . . . . . . . . . . . . . . . 15

    1

  • 8 Mars on Mac OS X 15

    A Change History 16A.1 Mars 2.2.7 March 22, 2004 . . . . . . . . . . . . . . . . . . . . . 16A.2 Mars 2.2.6 March 1, 2004 . . . . . . . . . . . . . . . . . . . . . 16A.3 Mars 2.2.5 February 10, 2004 . . . . . . . . . . . . . . . . . . . 17A.4 Mars 2.2.4 February 4, 2004 . . . . . . . . . . . . . . . . . . . . 17A.5 Mars 2.2.3 January 26, 2004 . . . . . . . . . . . . . . . . . . . . 18A.6 Mars 2.2.2 March 11, 2003 . . . . . . . . . . . . . . . . . . . . . 18A.7 Mars 2.2.1 February 25, 2003 . . . . . . . . . . . . . . . . . . . 19A.8 Mars 2.2.0 October 28, 2002 . . . . . . . . . . . . . . . . . . . . 19A.9 Mars 2.1.3 August 12, 2002 . . . . . . . . . . . . . . . . . . . . 20A.10 Mars 2.1.2 July 14, 2002 . . . . . . . . . . . . . . . . . . . . . . 20A.11 Mars 2.1.1 June 30, 2002 . . . . . . . . . . . . . . . . . . . . . 20A.12 Mars 2.1.0 June 5, 2002 . . . . . . . . . . . . . . . . . . . . . . 20A.13 Mars 2.0.0 May 8, 2002 . . . . . . . . . . . . . . . . . . . . . . 21

    1 About Mars

    Mars is a simple services-oriented network status monitor written in Java. Itmonitors a network by simulating client connections to Internet services andreporting when those services are not responding. It is quick and easy to in-stall and configure, which distinguishes it from other, more complex networkmonitoring tools.

    2 The Mars Distribution

    The Mars distribution is available at http://www.altara.org/mars.html.Mars is released under the GNU General Public License, version 2. This meansyou are free to modify and redistribute it, provided that you make your mod-ifications available under the GPL. The text of the GPL is available in theCOPYING file in the doc directory in the Mars distribution for details.

    The Mars distribution contains the following open-source software; the li-censes for these packages are found in the doc directory in the Mars distribution.We thank the developers of these packages for making them available.

    GNU Getopt version 1.0.9, by Aaron Renn.

    JDOM beta 9, c2000-2003 Brett McLaughlin and Jason Hunter, all rightsreserved. JDOM is developed by the JDOM Project at http://www.jdom.org/.

    Apache Xerces-J 2.6.0, c1999-2003 The Apache Software Foundation, allrights reserved. Xerces is developed by the Apache Software Foundationat http://www.apache.org/.

    2

  • Apache Jakarta-Oro 2.0.8, c1999-2003 The Apache Software Foundation,all rights reserved. Jakarta-Oro is developed by the Apache Software Foun-dation at http://www.apache.org/.

    In addition, Mars is packaged with several probe extensions and plugins,in the extras directory.. All of these extensions are released under the GNUGeneral Public License, version 2. All are c2003-2004 Leapfrog Research andDevelopment, LLC, except the following:

    HTTPS Probe Extension, c2003 Scott Ahten.

    3 Installing Mars

    The Mars distribution is self-contained; simply move the distribution directoryto a convenient place and youre ready to go. This is known as the Mars homedirectory. To use optional extensions shipped in the extras directory, simplymove them to the home directory. Though Mars is designed to be run from itshome directory, this behavior can be changed with the --home command-lineswitch described below.

    Mac OS X users: see section 8 for information on installing Mars on MacOS X.

    3.1 System Requirements

    Mars is a Java application, and therefore requires a Java runtime environmentto be installed on your machine before running. Any J2SE runtime version 1.3or later should do. Mars 2.2.5 has been tested to run on the following Javaruntime environments:

    Sun JRE 1.4.2-03 for Linux/i586

    Java 1.4.1-01 for Mac OS X 10.3 (Panther)

    Mars also requires an XML parser. Java 1.4 includes an XML parser, andthe Mars distribution includes Apache Xerces for running on Java 1.3, so thisisnt really a requirement you need to worry about.

    3.2 Distribution Contents

    The Mars core is distributed in two versions, mars.jar for Java 1.4. andmars-j13.jar for Java 1.3. The only difference between the two versions isthat the former contains an XML parser (Apache Xerces), which is includedwith the JRE on Java 1.4. The distribution directory contains only the formerjar file; mars-j13.jar is available as a separate download.

    The distribution directory contains the probe definition file mars-def.xml,which defines the protocols for text-based services Mars knows about. See theHackers Guide for the structure of this file.

    3

  • Figure 1: The Mars main window with a new, empty configuration

    The distribution directory also plugin and probe extension classes distributedwith Mars in the extras directory. Note for users of Mars 2.2.5 and earlierversions: all plugins and probe extensions have been moved to extras; youllneed to move these to the Mars home directory to use them.

    4 Starting Mars

    To run Mars, run mars.jar (for Java 1.4 or later) or mars-j13.jar (for Java1.3), either by double-clicking on it (in the Macintosh Finder or WindowsExplorer) or by changing to the Mars home directory and typing java -jarmars.jar.

    When running Mars from the command line, you can specify a previously-saved Mars configuration file to open on startup. In addition, the followingcommand-line options are available:

    --home specify a home directory from which to load extensions and the probedefinitions file. Defaults to . (the current working directory).

    --nogui start without the graphical user interface. This is useful for running themail notification plugin or seeing status changes on the console. Requiresa configuration file to be given.

    --geom start the graphical user interface with the specified geometry, expressedas width and height in pixels joined with an x, for example, 800x600.

    4

  • Figure 2: The Mars host editor

    Example: to run Mars in /usr/mars/mars.jar, loading plugins from/.mars/ and the configuration file /mars-config.xml without starting theuser interface, type:

    java -jar /usr/mars/mars.jar --nogui --home /.mars/mars-config.xml

    When Mars starts, the splash screen will appear momentarily, informing youof any extensions it finds and loads on startup. The the main window appears(see figure 1. The Mars main window has three parts: a host/service tree, afault list, and a service detail panel. The host/service tree displays the hosts andservices Mars knows about; when Mars is actively monitoring, it also displaysthe status of each service. The fault list displays all current problems withmonitored services. The service detail display shows relevant details about theservice selected in the host/service tree.

    5 Adding Hosts and Services

    The host/service tree can be manipulated in two ways: through a context menuon the tree, or via keyboard commands.

    By right-clicking (control-clicking on Macintosh) on a host or service in thetree, or on blank space within the tree, you can bring up the context menu,which allows you to access relevant tree editing operations. Since youve startedwith a new configuration, the host/service tree is empty; anywhere you right-click will bring up a context menu with a single option, New Host.... Select thisoption to bring up a host editor on a new host.

    5.1 The Host Editor

    The host editor (see figure 2) has two fields:

    Name is the name by which you want Mars to refer to the host; it could be thehost name without the domain, or a descriptive name (e.g. Web Server)completely unrelated to the hosts actual DNS name.

    Address is the fully qualified DNS name or IP address of the host. Marswill perform a lookup of the given name before adding the host to the

    5

  • Figure 3: The Mars service editor

    host/service tree, and will not allow you to continue unless the givenname resolves to an address; this ensures you dont get false alarms aboutservices being down because of a typo in the Address field.

    5.2 The Service Editor

    Now that youve defined a host, you need to define a set of services to monitoron that host. Right-click (control-click) on the host name to bring up the hostcontext menu and select Add Service..., which will bring up a service editor ona new service on the selected host.

    The service editor (see

Recommended

View more >