|
InterMapper® is a network monitoring and alerting program. It provides an early-warning system that alerts an administrator to problems with their network servers and IP and AppleTalk networks. For more information about InterMapper, please visit our web site at:
InterMapper consists of two components: InterMapper Server, which provides monitoring and alerting, and InterMapper DataCenter, which provides additional tools such as an SQL database and an authentication proxy that can be shared between InterMapper Servers.
InterMapper Server and InterMapper DataCenter run entirely in the background on Mac OS X — they are UNIX daemons. They begin running when your computer boots up, before any users are logged in, and continues running even when no user is logged in.
InterMapper Server does not have its own graphical user interface. To interact with InterMapper Server, you can use either the built-in InterMapper client or the InterMapper RemoteAccess application. The InterMapper client allows you to connect to the InterMapper Server running on your own machine. InterMapper RemoteAccess allows you to connect to InterMapper servers running on any computer on a TCP/IP network.
InterMapper DataCenter uses a web-based graphical user interface. To interact with InterMapper DataCenter once it is installed, open a web browser and navigate to:
InterMapper 5.2.3 for MacOS X is shipped as a Mac OS X Installer package (.pkg file) which contains the necessary programs and support files for both InterMapper Server and InterMapper DataCenter. Here are the instructions for installing InterMapper if you are directly in front of the computer.
Double-click the file InterMapper-5.2.3.pkg and follow the instructions. You will need an Administrator password to install this software.
The installation process will place a copy of the InterMapper client application in your Applications folder on your hard drive. When the installer finishes, it will launch the InterMapper client so you can view and configure your InterMapper Server.
The installation process will place InterMapper DataCenter files in the /usr/local/imdc directory on your hard drive. When the installer finishes, it will launch your default web browser, pointed to the InterMapper DataCenter web interface, so you can view and configure InterMapper DataCenter.
You will need a serial number or license certificate to run InterMapper for more than one hour. If you are a customer with a current maintenance contract, your FULL license certificate will work. If not, you can get a serial number via e-mail from:
The fastest way to get InterMapper running is to read the InterMapper Quick Start Guide or watch a Video Clip. In 15 or 20 minutes, you'll be monitoring your network with a map of your network.
The InterMapper manual is available in PDF and on-line HTML formats. The manual is also available locally via the Help menu in the InterMapper client.
For more information about InterMapper DataCenter, including tips on getting your directory server to work with the InterMapper Authentication Server component, please read the tech note below. The InterMapper DataCenter web interface also contains help links in many areas, which can be clicked to reveal additional instructions.
Please visit our What's New? page for a list of the new features in InterMapper Server and InterMapper DataCenter 5.2.3.
The Release Notes describe the new features and bug fixes in this version.
After running the InterMapper .pkg installer, the following files will be on your disk:
MacOS X 10.6 and later will create the following installation receipt files:
MacOS X versions prior to 10.6 will create a single installation receipt file:
The following system start-up configuration files are also created:
The file intermapperauthd will be made setuid-root. It is used by intermapperd to access low-level network services, such as ICMP ping and low-numbered network ports.
The Start.sh, Stop.sh and Uninstaller.sh scripts are described in detail below. The Extension.sh, TestScript.pl and relaunch scripts are used internally by InterMapper, and for diagnostics.
There will be a new directory called /usr/local/imdc on your hard disk. This directory contains the files that InterMapper DataCenter requires to run, including configuration and log files.
The installer will create a new 'intermapper' user and 'intermapper' group on your system, if they do not exist already. Configuration and log files in /usr/local/imdc are owned by this user and group. Log and configuration files are not given public read access. If you intend to read these files, you will need to either add yourself to the intermapper group, or use 'sudo'.
The best way to start and stop InterMapper Server and InterMapper DataCenter is to use the InterMapper Control Center, available on the right side of the Mac OS X menu bar. InterMapper Control Center will also indicate whether InterMapper Server is currently running and display the version of the installed software.
To start InterMapper Server and InterMapper DataCenter from the command line, type:
sudo /usr/local/share/intermapper/Start.sh
sudo /usr/local/imdc/sbin/imdc start
To stop InterMapper Server and InterMapper DataCenter, use the similar "stop" command:
sudo /usr/local/share/intermapper/Stop.sh
sudo /usr/local/imdc/sbin/imdc stop
To query the version of InterMapper that is installed, type one of the following:
/usr/local/bin/intermapperd -v
/usr/local/imdc/sbin/imdc -v
To check if InterMapper Server and InterMapper DataCenter are currently running, type:
ps acux | grep intermapperd
ps acux | grep imdc
To remove the InterMapper software from your system, type:
sudo /usr/local/share/intermapper/Uninstaller.sh
You can also run the InterMapper installer package again, and click on the uninstall link at the bottom of the welcome screen.
Uninstalling InterMapper preserves the settings for both InterMapper Server and InterMapper DataCenter. Thus, if you are not planning to reinstall InterMapper and wish to remove it completely, then after removing the software, you must manually remove the /usr/local/imdc directory, as well as the "InterMapper Settings" directory located at "/Library/Application Support/InterMapper Settings".
To install InterMapper from the command line, you can use the installer -pkg "location" -target / command.
When you install InterMapper Server by double-clicking on the ".pkg" icon, InterMapper Server is configured to run as the user you are logged in as. When you install InterMapper Server via the command-line however, its configuration will default to run as the user name intermapper. Before installing InterMapper, you should create a user named 'intermapper' or follow the instructions of step 2 below to use a different user name.
Here are the instructions for installing InterMapper Server from the command line:
If you wish to run as the intermapper user, type the following command. You will be prompted for an administrator password:
sudo installer -pkg "InterMapper-5.2.3.pkg" -target /
When the installer finishes, InterMapper Server will attempt to run as the user 'intermapper'.
If there is no 'intermapper' user on your system, you can specify an alternative name using a configuration file:
# Install InterMapper as existing user named "joe".
sudo sh -c 'echo "USER joe" > /usr/local/etc/intermapperd.conf'
sudo installer -pkg "InterMapper-5.2.3.pkg" -target /'
Double-click your copy of InterMapper to launch the GUI client. Use InterMapper to view and configure your InterMapper Server.
You can also use InterMapper RemoteAccess to administer the InterMapper Server from another computer. However, before the server will accept connections from RemoteAccess, you must tell it where you will connect from:
sudo /usr/local/share/intermapper/Stop.sh
sudo /usr/local/bin/intermapperd --setenv "Admin=remote:password@*.*.*.*"
sudo /usr/local/share/intermapper/Start.sh
The --setenv Admin "remote:password@*.*.*.*" option tells InterMapper Server to accept Administrator connections from any IP address (*.*.*.*) with the user ID "remote" and the password "password". Immediately after you restart the server, you should launch InterMapper RemoteAccess on another computer and log into InterMapper Server to fully configure its users and groups.
We love to hear from customers. Please write to us at support@dartware.com with any comments, suggestions, and bug reports. Thank you for your support and enthusiasm!
Copyright © 2007-2010, Dartware, LLC.