Difference between revisions of "Cartographer Agent Installation"

Revision as of 09:17, 22 October 2008

Overview

There is a single Cartographer agent release that encompasses all supported platforms. That is, the single release contains binaries, libraries, plugins, and configuration files needed to run on all supported platforms. Files are built using a naming scheme that identifies the platform that they are compiled for.

Home Directory Location

The default/suggested locations for Cartographer agent installation are listed below. However, the software can be installed in virtually any location that is suitable for your distributed system. It is recommended, though, that the software not be installed on remote filesystems nor network shares. The software should be installed on a local filesystem.

• UNIX /opt/cartographer
• Win32/64 c:\program files\cartographer

Unpack the Release

The software is available in tar and zip formats.

• UNIX

mkdir /opt/cartographer
cd /opt/cartographer
tar xvof /path-to-release/release.tar

mkdir /opt/cartographer
cd /opt/cartographer
unzip release.zip

• Windows

Double-click on the zip file and extract to c:\program files\cartographer.

File Manifest

The agent release contains all files for all platforms. Files that are platform-specific contain a suffix specifying the platform they are compiled for. The platform-specific suffixes are identified below. The files included in each release are:

• Agent Binaries
  • xmpd-linux, xmpd-solaris, xmpd-solx86, xmpd-win32.exe

• MIB2 Plugins
  • mib2-linux.so, mib2-solaris.so, mib2-solx86.so, mib2-win32.dll

• Cartographer Plugins
  • cartographer-linux.so, cartographer-solaris.so, cartographer-solx86.so, cartographer-win32.dll

• Test Plugins
  • testplugin-linux.so, testplugin-solaris.so, testplugin-solx86.so, testplugin-win32.dll

• Tools
  • XMP Query tool: xmpquery-platform-suffix

Setup Automatic Startup

Configuration

Starting and Stopping the Cartographer Agent

Supported Platforms and Platform Specific Notes

Cartographer agents run on the following platforms:

• Solaris 9+ Sparc/64-bit (-solaris platform suffix)
• Solaris 9+ on x86 (-solx86 platform suffix)
• Linux systems containing 2.4+ kernels on x86 (-linux platform suffix)
• Windows 2000/XP/2003/Vista (-win32 platform suffix)

Notes:

• Support for 64-bit Windows (win64) is undergoing testing.
• Testing on 64-bit Linux kernels is underway.
• A port to MacOS is being contemplated but has not yet been finalized.
• Ports to neither the iPhone/iPod nor Android have been planned at this time.
• On Solaris, Cartographer agents are started with init scripts rather than the service management facility
• The agent release contains its own builds of OpenSSL that conform to our platform-specific naming scheme. Doing so makes installation and deployment, as well as upgrading, simpler and more consistent. The current version of OpenSSL shipped with Cartographer is 0.9.8g 19 Oct 2007.
• On UNIX, we use the native XML libraries; on Windows, we distribute a Windows version of libxml2.
• On UNIX, we use the native POSIX threading libraries (pthreads); on Windows, we distribute a Windows version of pthreads.

See Also

• Warranty
• License agreement
• Cartographer
• XMP
• Software Distributions
• Cartographer GUI Installation
• Libxml2
• Pthreads for Win32