Difference between revisions of "Cartographer Agent Installation"
(→File Manifest) |
(→File Manifest) |
||
| Line 55: | Line 55: | ||
** init.linux - Linux ''/etc/init.d'' script | ** init.linux - Linux ''/etc/init.d'' script | ||
** init.solaris - Solaris ''/etc/init.d'' script | ** init.solaris - Solaris ''/etc/init.d'' script | ||
| + | ** cartographertray.exe -- Windows system tray program | ||
* '''Libraries''' | * '''Libraries''' | ||
| + | ** libssl-''platformsuffix'' - OpenSSL library | ||
| + | ** libcrypto-''platformsuffix'' - OpenSSL crypto library | ||
| + | ** libxml2.dll - Windows libxml2 library | ||
| + | ** ssleay32.dll, libeay32.dll - OpenSSL libs for win32 | ||
| + | ** zlib1.dll - Windows zlib library for data compression | ||
| + | ** pthreadVC1.dll - Windows pthreads library | ||
| + | ** inconv.dll - Windows library for character encoding conversions | ||
| + | |||
| + | * '''Configuration Files''' | ||
| + | ** xmpd.xml - Agent configuration settings | ||
| + | ** cartographer.pem - Agent certificate authority keys | ||
| + | ** appdata.xml - Cartographer plugin data file storing application data | ||
| + | ** connectiondata.xml - Cartographer plugin data file storing connection data | ||
| + | ** cartographer.xml - Cartographer plugin configuration settings | ||
==Setup Automatic Startup== | ==Setup Automatic Startup== | ||
Revision as of 09:47, 22 October 2008
Contents |
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-platformsuffix
- MIB2 Plugins
- mib2-platformsuffix
- Cartographer Plugins
- cartographer-platformsuffix
- Test Plugins
- testplugin-platformsuffix
- Tools
- ntsetup.exe - NT setup utility for configuring agent to run as Windows service
- xmpquery-platformsuffix - XMP query tool
- xmptomrtg-platformsuffix - XMP query tool that outputs data in MRTG format
- restartxmpd.exe - tool used by agent engine to restart itself during automatic upgrades
- restartxmpd.sh - tool used by agent engine to restart itself during automatic upgrades
- init.linux - Linux /etc/init.d script
- init.solaris - Solaris /etc/init.d script
- cartographertray.exe -- Windows system tray program
- Libraries
- libssl-platformsuffix - OpenSSL library
- libcrypto-platformsuffix - OpenSSL crypto library
- libxml2.dll - Windows libxml2 library
- ssleay32.dll, libeay32.dll - OpenSSL libs for win32
- zlib1.dll - Windows zlib library for data compression
- pthreadVC1.dll - Windows pthreads library
- inconv.dll - Windows library for character encoding conversions
- Configuration Files
- xmpd.xml - Agent configuration settings
- cartographer.pem - Agent certificate authority keys
- appdata.xml - Cartographer plugin data file storing application data
- connectiondata.xml - Cartographer plugin data file storing connection data
- cartographer.xml - Cartographer plugin configuration settings
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.
