Installing the Cartographer GUI

Overview

The Cartographer GUI is a completely native Java application (not Applet) that does not require any additional libraries or Jar files other than what comes with the standard Sun distribution. It does not require any Java Native Interface (JNI) access to system nor third-party libraries. It communicates with Cartographer agents using the [XMP] protocol and can discover and display the dependencies between systems and applications.

Java Requirements

The Cartographer GUI application is written in native Java and Swing and currently uses only bundled libraries that ship with the Sun distribution. Testing has not been done with non-Sun Java installations.

%java -version
java version "1.6.0_01"
Java(TM) SE Runtime Environment (build 1.6.0_01-b06)
Java HotSpot(TM) Server VM (build 1.6.0_01-b06, mixed mode)

Development and testing of the Cartographer GUI occurs primarily on Linux and Solaris. Testing is occasionally performed on Windows.

Starting Cartographer GUI

Start the Cartographer GUI by first changing to the directory that it is installed in.

% java -jar Cartographer.jar

After starting, you will see the initial window:

Check and modify any options via the dialog shown below. In particular, make sure that the authenUser parameter is set to that which you configured Cartographer agents to communicate with. The authenUser parameter can be thought of similar to an SNMP community string in that it is used to identify a set of allowable protocol operations and access permissions. However, unlike SNMP, XMP communication provides for privacy and authentication via its use of SSL.

Discovering a System

Discover a system by launching the Discover dialog.

Once the system is identified, via domain name or IP address, Cartographer GUI establishes a session with the Cartographer agent residing on that system. Its dependencies, peers, and system information is queried. If the discover operation was initiated with depth greater than zero, the discover thread will attempt to do a depth-first-search (DFS) of the dependency graph between the target system and others. The discover operation will proceed up to the specified depth.

See Also

• Warranty
• License agreement