Intermapper Installation Guide 6.5.3

Intermapper Installation
Guide
6.5.3
Copyright Terms and Conditions
Copyright Help/Systems LLC and its group of companies.

The content in this document is protected by the Copyright Laws of the United States of America and other countries worldwide. The
unauthorized use and/or duplication of this material without express and written permission from HelpSystems is strictly prohibited.
Excerpts and links may be used, provided that full and clear credit is given to HelpSystems with appropriate and specific direction to the
original content. HelpSystems and its trademarks are properties of the HelpSystems group of companies. All other marks are property
of their respective owners.
202107150207
Table of Contents
Before You Begin 6
Intermapper Components 6
System Requirements 7
Virtual Machine and Intermapper License Keys 7
Software Requirements for Intermapper, Intermapper Remote Access, and Intermapper Flows 7
Minimum Hardware Requirements 8
Intermapper Application Server 8
Intermapper Flows 9
Intermapper Remote Access 10
Installing Intermapper on Microsoft Windows Systems 11
What is Installed and Where 11
Managing Intermapper Services 12
Starting Intermapper 12
Starting Intermapper Flows 12
Uninstalling Intermapper 13
Installing Intermapper on SuSE Linux Systems 14
Installing From a Command Line 14
Upgrading Intermapper 14
Upgrading From a Command Line 14
OpenSuSE 14
Installing the Intermapper Public Key 15
Java Runtime Environment 15
Intermapper DataCenter 16
Managing Intermapper Daemons 17
Setting a Password for Intermapper Data Center 18
Intermapper Installation Guide www.helpsystems.com page: 3

Table of Contents
Installing Intermapper on Mac OS X Systems 20

Advanced Installation Instructions 20
Upgrading on MacOS X High Sierra Systems 20
Installing Intermapper on Debian and Ubuntu Linux Systems 25
Installing Intermapper Using apt-get 25
Configuring Intermapper Remotely 29
Setting a Password for Intermapper DataCenter 30
Installing Intermapper on Red Hat Linux Systems 31
Installing the Intermapper Public Key 31
Installing Intermapper 31

Table of Contents
Installing Intermapper Remote Access 36
Microsoft Windows Systems 36
Mac OS X Systems 36
Linux Systems 36
Uninstalling Intermapper Remote Access 37
After You Are Done 38
License and Firewall Information 38
Other Resources 38
Contacting Us 38

Before You Begin
Read this section before you install Intermapper® or Intermapper Remote Access.
Intermapper Components
Intermapper is a network mapping, monitoring, and alerting program. It provides an early warning
system that alerts an administrator to problems with their network servers and IP networks. For
more information on Intermapper, visit our website at www.intermapper.com.
Intermapper includes the following components:
l Intermapper Server - provides the core facilities of Intermapper, including discovery,
polling and monitoring, charting, and alerting.
l Intermapper Flows - collects NetFlow and sFlow data from routers and switches. It saves
the flow records in a database and displays data about traffic senders, recipients, type, and
volume.
l Intermapper DataCenter - provides the following tools:
o Intermapper Authentication Server - allows you to authenticate users to external
Active Directory, LDAP, RADIUS, Kerberos, and IAS directories.
o Intermapper Database - a PostgreSQL database that stores historical data from
Intermapper servers.
o Intermapper Reports - reports are generated from the Intermapper database.
You can use the built-in Intermapper client to connect to the Intermapper server running on your
own machine or you can remotely connect to Intermapper servers anywhere on your network
using Intermapper Remote Access.

System Requirements
Virtual Machine and Intermapper License
Keys
To use a license key, the following variables must remain static:
l Hostname
l IP address
l MAC address
NOTE:
You can set the variables when you create a new virtual machine.
A change in hardware attributes (CPU, storage, or memory) within the same system does not
affect how the Intermapper server or Intermapper Remote Access™ operate. If you move to new
system hardware, you must obtain a new license key.
A change in the Network Interface Card (NIC) requires a new license key; the MAC address is
unique and is tied to a network interface (physical, virtual, or wireless).
Software Requirements for Intermapper,

Intermapper Remote Access, and
Intermapper Flows
To install and run Intermapper, Intermapper Remote Access, and Intermapper Flows, your
configuration must meet the following requirements:
Platform Operating System Level

Debian 9 or 10
Mac OS X 10.13, 10.14, or 10.15
Microsoft Windows Server on x64 systems 8.1 or 10
Microsoft Windows Server 2012 R2, 2016, or 2019
*IPV6 support requires Microsoft Windows Server 2008 or
higher
Red Hat Enterprise Linux on x64 systems 7 or 8

SuSE Linux Enterprise Server 12
Ubuntu 16.04, 18.04, or 19.10

Minimum Hardware Requirements
If you install Intermapper on a headless server, use a remote desktop access program that
supports remote sounds or a copy of Intermapper Remote Access.
Running Intermapper on a Mac OS virtual machine is not supported.

Intermapper Application Server
To install and run the Intermapper Application Server, your configuration must meet the
following requirements:
Hardware Requirement
Processors Two (2) Virtual CPUs dedicated and reserved
for App server
Memory (RAM)
Mac OS and Linux 8 GB exclusively to the Application Server
Microsoft Windows 16 GB exclusively to the Application Server
Disk Configuration
OS Drive Array 100 GB 10k SAS of pre-allocated disk space
Data Drive Array 350 GB 10k SAS of pre-allocated disk space
NOTE:
These recommendations support up to 500 devices. As your device counts increase, so do
storage requirements.
page: 8 www.helpsystems.com Intermapper Installation Guide

Intermapper Flows
To install and run the Intermapper Flows, your configuration must meet the following
requirements:
Virtual Machines
Intermapper Flows Four (4) Virtual CPUs for Intermapper Flows
Mac OS and Linux 8 GB (RAM) exclusively to the Intermapper Flows
Microsoft Windows 16 GB (RAM) exclusively to the Intermapper Flows
Dedicated Hardware Two (2) or more of the latest generation Intel or AMD
processors with at least four (4) processor cores each.
Recommend processing speed us 2.5Ghz or higher
Disk Configuration
OS Drive Array 100 GB 10k SAS
Data Drive Array 350 GB 10k SAS
Up to 10 million flows/hour Quad Core, 16 GB of RAM
Requires 64-bit Microsoft Windows, Linux, or Mac
hardware
100 million flows/hour Quad Core, 3GHz, 65 GB of RAM, RAID storage
Requires 64-bit Microsoft Windows, Linux, UNIX, or
Mac hardware
NOTE:
Intermapper Flows requires a fairly powerful computer; both processor power and the
amount of RAM are important considerations. The minimum recommended specifications
support up to 10 million flows per hour.
Intermapper Flows benefits from having a large amount of RAM for its database cache. Use a
64-bit Windows, Mac, or Linux system to allocate more than 1.5 GB of RAM for the cache.

Intermapper Remote Access

To install and run Intermapper Remote Access, your configuration must meet the following
requirements:
Processor In general, any recent computer capable of
running a relatively current Mac, Microsoft
Windows, or Linux OS version can run
Intermapper Remote Access. A 64-bit OS is
required.
NOTE:
Intermapper Remote Access installs the supported Java runtime version.

Installing Intermapper on Microsoft
Windows Systems
To download Intermapper on a Microsoft Windows system:
1. Download the installer to a convenient location. If you are a current user, access the
download from the HelpSystems website (https://community.helpsystems.com). If you are
a new customer, use the link in the email received from HelpSystems to download
Intermapper. Double-click the Intermapper_Setup_6.5.3.exe file and follow the
instructions.
NOTE:
l You must be an administrator to install Intermapper.
l If you are installing a 64-bit version, you must uninstall previous 32-bit versions
installed on your system before you can run the installer. The Intermapper
Settings folder is compatible with the new 64-bit version; you should back it up
before you uninstall the previous version.
2. When the installer finishes, it starts the Intermapper client so you can view and configure
your Intermapper server.
What is Installed and Where

The components of Intermapper are installed as separate Microsoft Windows services. This
means that after you start them, they automatically start running when your computer starts,
before any users are logged in, and continues to run even when no user is logged in. For
information on managing these services, see Managing Intermapper Services.
The installer creates an Intermapper folder in the Microsoft Windows Program Files or Program
Files (x86) folder on your 64-bit Microsoft Windows system. This folder contains all of the
Intermapper core files. When it first starts, Intermapper creates an Intermapper folder in the
default Microsoft Windows ProgramData location. This folder contains settings and data that
Intermapper collects from your network. For example,
C:\Program Files\InterMapper
C:\Program Files\InterMapper\dwf
C:\Program Files\InterMapper\flows
C:\ProgramData\InterMapper - The "InterMapper Settings" folder
If it does not already exist, the installer creates an InstallShield or an InstallShield Shared
directory in Program Files/Common Files. These files are required for uninstalling Intermapper.
Intermapper adds license keys to the Microsoft Windows registry that it uses to identify the
installation location and local preferences.

Managing Intermapper Services
Managing Intermapper Services

You can start and stop Intermapper services with the Intermapper Control Center system tray
icon. The Intermapper and Intermapper DataCenter services are started and stopped
simultaneously. You can also start and stop individual services from the Microsoft Windows
service control panel.
Check if the Intermapper services are currently running with the Intermapper Control Center
system tray icon. You can also look for Intermapper.exe, flows.exe, and imdc.exe files in the Task
Manager or check their entries in the Services control panel.
You can find the version of Intermapper that is installed using the Intermapper Control Center.
You can also start a web browser and navigate to the web interface for Intermapper DataCenter.
The version number is displayed at the bottom of the page.
Starting Intermapper
The first time you start the Intermapper server, it accepts only connections from the local
machine. If you have a graphical interface and Java already installed, you can launch Intermapper
by clicking the Intermapper button from the Intermapper Control Center.
The fastest way to start using Intermapper is to read the Intermapper Quick Start Guide. In 15 or
20 minutes, you can be monitoring your network with a map of your network.
Starting Intermapper Flows

The fastest way to start using Intermapper Flows is to read Installing Intermapper Flows and
Intermapper Flows Overview.
Intermapper Flows does not automatically; you must use the Intermapper Control Center to start
it before you can access flows information.
When Intermapper Flows first starts, it creates a 10 GB flows database. You can change the
database size and location to fit your needs.
Intermapper Flows does not contain a separate graphical user interface. However, you can
access flow information either through the built-in Intermapper client or through Intermapper
Remote Access. You can open the Flows window by right-clicking a device on a map. When you
do this, you can see information about the traffic on the selected device.
If you purchased Intermapper with Flows, use the serial number to register your installation. If
you are only trying Intermapper out, your evaluation serial number allows you to receive data
from one exporter (source of NetFlow or sFlow data).
You do not need to configure Intermapper DataCenter if you access it from the local machine. To
enable external access and more advanced configuration, go to https://localhost:8182.
Intermapper DataCenter ships with a self-signed SSL certificate. Your browser displays a
certificate warning when you visit the DataCenter web interface. You can select the certificate
and safely continue to navigate to the page. The Intermapper DataCenter Settings page allows

Uninstalling Intermapper
you to upload your own certificate rather than relying on the less secure certificate shipped with
Intermapper.
To uninstall Intermapper, use the Programs and Features or Add or Remove Programs control
panel.
Uninstalling Intermapper does not remove the associated settings or data files. If you do not plan
on reinstalling Intermapper and want to remove it completely, manually remove the Intermapper
Settings, Intermapper Datacenter, and Intermapper Flows folder from the Microsoft Windows
Program Files and Program Data locations.

Installing Intermapper on SuSE Linux
Systems
Intermapper is shipped as an RPM package (.rpm file) and is available in the following package:
l 64-bit: Intermapper-6.5.3-1sse.x86_64.11x.rpm - includes 64-bit versions of
Intermapper server and Intermapper Flows server. These versions allow systems operating
near memory capacity to take advantage of increased memory space. A 64-bit package can
be installed only on a 64-bit release. If you are upgrading from a version previous to 5.8,
uninstall Intermapper as described below before you upgrade. HelpSystems recommends
that you back up your Intermapper Settings directory before you install Intermapper.
Installing From a Command Line

When installing on a 64-bit system, install 32-bit compatibility libraries. If 32-bit runtime
environment is selected during installation, 32-bit dependencies should already be met. If not,
locate the 32-bit runtime environment package group using the yast tool and install it.
Run the following commands:
cd <directory-containing-rpm>
sudo rpm -ivh InterMapper-6.5.3-1sse.x86_64.11x.rpm
Upgrading Intermapper
When you upgrade an existing Intermapper installation to a newer version, data is retained in the
Intermapper Settings folder. HelpSystems recommends that you create a backup of that folder
before you upgrade, just to be safe. For information on which files to back up, see What is
Installed and Where.
Upgrading From a Command Line

To upgrade to the 64-bit package, run the following commands:
sudo rpm -Uvh --nopreun InterMapper-6.5.3-1sse.x86_64.11x.rpm
OpenSuSE
The set of libraries required for OpenSuSE changes often, therefore it is difficult to offer
consistent advice about the required libraries. The best procedure is to run the Intermapper
installer using the procedure above. If you see messages about missing libraries, install the first
one with its dependencies, then run the Intermapper installer again. Repeat this procedure until
Intermapper is successfully installed.

Installing the Intermapper Public Key

The Intermapper RPM is signed with gpg to allow you to verify the integrity of the downloaded
file. To install the Intermapper gpg public key, run the following commands:
curl --output InterMapper_Key.asc -L

http://www.intermapper.com/go.php?to=gpgkey
sudo rpm --import <path_where_public_key_was_saved>/InterMapper_
Key.asc
After you import the key, rpm remembers it for future releases and you do not need to import it
again.
To check the signature on the Intermapper package before installing it, run the following
command:
rpm -K "InterMapper-6.5.3-1sse.x86_64.11x.rpm" #64-bit
If the package signature is correct, the following line is displayed:

InterMapper-6.5.3-1sse.x86_64.11x.rpm: (sha1) dsa sha1 md5 gpg OK
Java Runtime Environment

A compatible Java JRE is automatically installed with each version of Intermapper server. This file
runs the Intermapper client. It is not used with Intermapper's web interface.
The first time you start the Intermapper Server, it only accepts connections from the local
using the following command.
/usr/local/bin/intermapper
NOTE:
If you cannot run the above command, see Installing Java or Configuring Intermapper
Remotely.


Intermapper Flows does not include a graphical user interface. However, you can access flow
information either through the built-in Intermapper client or through Intermapper Remote
Access. Open the Flows window by right-clicking a device on a map. When you do this, you can
see information about the traffic on the selected device.
If you purchased Intermapper with Flows, use the serial number to register your installation. If
you are only trying Intermapper out, your evaluation serial number allows you to receive data
from one exporter source (NetFlow or sFlow data).
Intermapper Flows is not running by default. For information on starting Intermapper Flows, see
Managing Intermapper Daemons.
Intermapper DataCenter
Intermapper.

Intermapper components are installed as separate daemons. This means that after you start them,
they automatically begin running when your computer starts, before any users are logged in, and
continue running even when no user is logged in. For information on managing these daemons,
see Managing Intermapper Daemons.
The installer creates the following files and folders:
l /var/local/InterMapper_Settings - Intermapper Settings folder
l /usr/local/bin/intermapperd - Intermapper binaries and support files
l /usr/local/bin/intermapperauthd
l /usr/local/bin/intermapperflows
l /usr/local/man/man1/intermapperd.1
l /usr/local/man/man1/intermapperauthd.1
l /usr/local/share/intermapper - Intermapper support files
l /usr/local/imdc - Intermapper DataCenter folder
l /var/local/InterMapper_Settings/Flows - Intermapper Flows folder
l /var/local/InterMapper_Settings/Flows/SESSIONDB - default directory for the
flow database

Managing Intermapper Daemons
l /var/local/InterMapper_Settings/Flows/flows.conf - configuration file for

Intermapper Flows
l /var/local/InterMapper_Settings/Flows/services - port numbers and service
names
l /usr/local/share/intermapper/imflows_configure.sh
When Intermapper first starts, the Intermapper_Settings folder is created and stored in the
/var/local/Intermapper_Settings folder. This folder stores preferences, maps, and data
that Intermapper collects from your network. You can change the location of the Intermapper
Settings folder by editing Intermapper's configuration file (intermapperd.conf) located in the
/usr/local/etc folder.
The installer also creates a new folder /usr/local/imdc that contains the Intermapper
DataCenter's files, including data, configuration and log files.
The following system start-up scripts are created:
/etc/init.d/intermapperd
/etc/init.d/imflows
/etc/init.d/imdc
The intermapperauthd file is a setuid-root program. The intermapperd daemon (running
as a non-privileged user) makes requests to intermapperauthd to access low-level network
services, such as ICMP ping and low-numbered network ports.
The installer creates the intermapper user and intermapper group on your system, if they do not
exist already. The new user and group configuration and log files are stored in the Intermapper
Settings and Intermapper DataCenter folders. These log and configuration files are not granted
public read access. If you want to read these files, add yourself to the intermapper group or use
sudo in your commands.

To start and stop individual daemons, run the following startup scripts:
sudo /etc/init.d/intermapperd start

sudo /etc/init.d/imflows start
sudo /etc/init.d/imdc start
sudo /etc/init.d/intermapperd stop

sudo /etc/init.d/imflows stop
sudo /etc/init.d/imdc stop
To look up the version of Intermapper that is installed, run the following command:
/usr/local/bin/intermapperd -v
To check if Intermapper daemons are currently running, run the following commands:

Setting a Password for Intermapper Data Center
ps acux | grep intermapperd

ps acux | grep intermapperflow
ps acux | grep imdc
If your Intermapper server does not have a graphical interface, use Intermapper Remote Access
to administer the Intermapper server. Before the Intermapper server can accept connections
from Remote Access, launch the server with a command line argument, telling it where to
connect from. Run the following commands* to manually stop the intermapperd process and
restart using the -A option:

sudo /usr/local/bin/intermapperd -f /usr/local/etc/intermapperd.conf
-A "remote:password@*.*.*.*"
*For installations that do not have sudo installed, it is not required. The commands must be run as root; the sudo
command can be omitted.
The Intermapper server accepts administrator connections from any IP address (*.*.*.*) with the
user identifier of remote and the password of password. Launch Intermapper Remote Access on
another computer, log into the new Intermapper system, and set up your Intermapper users and
groups.
Setting a Password for Intermapper Data

Center
Intermapper DataCenter requires its initial configuration to be performed.
The Intermapper DataCenter configuration page, accessed from a browser, requires its own
password.
sudo /usr/local/imdc/sbin/imdc stop

sudo /usr/local/imdc/sbin/imdc --password=[password]
sudo /usr/local/imdc/sbin/imdc start
Now you can connect to Intermapper using one of the following URLs:
l https://localhost:8182/setting.html
l https://IPaddress:8182/setting.html
l https://domain name:8182/setting.html
To remove Intermapper from your system, use the system's graphical package manager or run the
following command:
sudo rpm -ev InterMapper

When you uninstall Intermapper, the settings and data files are not removed. If you do not plan
Settings, Intermapper Flows, and Intermapper DataCenter folders using the following
commands:
sudo rm -rf /var/local/InterMapper_Settings

sudo rm -rf /usr/local/imdc
sudo deluser intermapper

Installing Intermapper on Mac OS X
Systems
To download Intermapper on a Mac OS X system:
1. Download the installer to a convenient location. If you are a current user, access the
download from the HelpSystems website (https://community.helpsystems.com). If you are
a new customer, use the link in email you received to download Intermapper.
2. Double-click the .dmg installer file to open the disk image.
3. Double-click the Intermapper-6.5.3.pkg file and follow the instructions. You must be an
Administrator to install this software.
4. When the installer finishes, it launches the Intermapper client to view and configure your
Intermapper server.
Advanced Installation Instructions

To install Intermapper from the command line, run the following command and double-click your
copy of Intermapper to launch the client to view and configure your Intermapper server:
sudo installer -pkg "InterMapper-653.pkg" -target /
You can also use Intermapper Remote Access to administer the Intermapper server from another
computer. However, before the server can accept connections from Remote Access, you must
tell it where to connect from using the following commands:
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 of remote
and the password of password. After you restart the server, launch Intermapper Remote Access
on another computer, log into the Intermapper server to set up the Admin user with a strong
password, and set the allowed addresses for the remote server access list.
Upgrading on MacOS X High Sierra

Systems
Intermapper now supports MacOS X High Sierra (version 10.13).
Before you upgrade:
1. Back up your Intermapper Settings folder.
2. Uninstall Intermapper using the following command:

sudo /usr/local/share/intermapper/Uninstaller.sh
3. Remove the Intermapper user and group using the following commands:
sudo dscl . delete /groups/intermapper
sudo dscl . delete /users/intermapper
4. Reinstall Intermapper.
After you upgrade:

After installation, High Sierra clears the setuid bit (sticky bit) for intermapperauthd, even
though it is configured during installation. As a result, Intermapper cannot open low-numbered
ports used by some probes. To work around this issue, run the following command:
sudo chmod u+s /usr/local/bin/intermapperauthd

Intermapper components are installed as separate Mac OS X daemons. This means that after you
start them, they automatically start running when your computer starts, before any users are
logged in. It continues to run even when no user is logged in. For information on managing these
daemons, see Managing Intermapper Daemons. The installer creates the following files and
folders:
l /Library/Application Support/InterMapper Settings - Intermapper Settings
folder
l /Applications/InterMapper.app
l /usr/local/bin/intermapperd
l /usr/local/share/intermapper/Start.sh
l /usr/local/share/intermapper/Stop.sh
l /usr/local/share/intermapper/Extension.sh
l /usr/local/share/intermapper/Uninstaller.sh
l /usr/local/share/intermapper/TestScript.pl
l /usr/local/share/intermapper/relaunch
l /Library/Application Support/InterMapper Settings/Flows - Intermapper
Flows folder
l /Library/Application Support/InterMapper Settings/Flows/SESSIONDB -
directory for the database of flow information. This can be moved to a different drive
using the Intermapper Flows Settings.
l /Library/Application Support/InterMapper Settings/Flows/flows.conf
- the configuration file for Intermapper Flows

l /Library/Application Support/InterMapper Settings/Flows/flows_

knowngood.conf - the last known good configuration file
l /Library/Application Support/InterMapper Settings/Flows/services -
port numbers and service names
l /usr/local/bin/Intermapperflows - binary for the Intermapper Flows daemon
When Intermapper first starts, the Intermapper Settings folder is created in the
/Library/Application Support/Intermapper Settings directory. This folder stores
settings and data that Intermapper collects from your network.
Intermapper DataCenter creates the /usr/local/imdc folder that contains the core IMDC
files, including configuration and log files.
For MacOS X 10.7 and higher, the following installation files are created:
l /var/db/receipts/com.dartware.InterMapperPkg.bom
l /var/db/receipts/com.dartware.InterMapperPkg.plist
The following system start-up configuration files are also created:
l /Library/LaunchDaemons/com.dartware.InterMapperServer.plist
l /Library/LaunchDaemons/com.dartware.InterMapperDataCenter.plist
l /Library/LaunchDaemons/com.dartware.InterMapperFlows.plist
The intermapperauthd file is a setuid-root program. The intermapperd daemon (running as
a non-privileged user) makes requests to intermapperauthd 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 for
diagnostic purposes.
The installer creates the intermapper user and the intermapper group on your system, if they do
not exist already. The new user and group configuration and log files are stored in the
Intermapper Settings and Intermapper DataCenter folders. These files are not granted public read
access. If you want to read these files, add yourself to the intermapper group or use sudo in your
commands.

You can start and stop Intermapper daemons with the Intermapper Control Center, available on
the right side of the Mac OS X menu bar. The Intermapper and Intermapper DataCenter daemons
are started and stopped simultaneously. You can also manually start and stop individual daemons
using the following commands:
# commands to start InterMapper, the DataCenter, and Flows

sudo /usr/local/share/intermapper/Start.sh
sudo launchctl load -F
/Library/LaunchDaemons/com.dartware.InterMapperDataCenter.plist

sudo launchctl load -F

/Library/LaunchDaemons/com.dartware.InterMapperFlows.plist
# commands to stop InterMapper, the DataCenter, and Flows

sudo /usr/local/share/intermapper/Stop.sh
sudo launchctl unload -F
/Library/LaunchDaemons/com.dartware.InterMapperDataCenter.plist
sudo launchctl unload -F
/Library/LaunchDaemons/com.dartware.InterMapperFlows.plist
You can look up the version of Intermapper that is installed from the Intermapper Control
Center. You can also start a web browser and navigate to the web interface for Intermapper
DataCenter. The version number is displayed at the bottom of the page. You can also run the
following command:

ps acux | grep intermapperflows
ps acux | grep imdc

Intermapper Flows does not run by default. Use the Intermapper Control Center to start it to
access flows information.
Intermapper Flows does not have its own graphical user interface. However, you can access flow
Access. You can open the Flows window by right-clicking a device on a map. When you do this,
you can see information about the traffic on the selected device.
If you purchased Intermapper with Flows, you can use the serial number to register your
installation. If you are only trying Intermapper out, your evaluation serial number allows you to
receive data from one exporter (NetFlow or sFlow data).
Intermapper Flows is not running by default, so you must use the Intermapper Control Center to
start it before you can access flows information.

certificate warning when you go to the DataCenter web interface. You can select the certificate
Intermapper.
To remove Intermapper from your system, run the following command:
sudo /usr/local/share/intermapper/Uninstaller.sh
Settings, Intermapper Flows, and Intermapper DataCenter folders using the following commands:
sudo rm -rf "/Library/Application Support/InterMapper Settings"


Installing Intermapper on Debian and
Ubuntu Linux Systems
Intermapper is shipped as a Debian package (.deb file) and is available in the following package:
l 64-bit: intermapper_6.5.3-6.5.2-1_amd64.deb - includes 64-bit versions of Intermapper
server and Intermapper Flows server. These versions allow systems operating near
memory capacity to take advantage of the increased memory space. The 64-bit package
can be installed only on a 64-bit Debian release.
The Debian package can be installed using the system's graphical package manager or from a
command line as described below.

Run the following command:
sudo dpkg -i "intermapper_6.5.2–5.0.10-1_amd64.deb"
The curl command above appends the following to the apt sources.list file:
#-----------------------------------------------------------------#
# OFFICIAL UBUNTU REPOS #
#-----------------------------------------------------------------#
###### Ubuntu Main Repos
deb http://am.archive.ubuntu.com/ubuntu/ bionic main restricted
universe
deb-src http://am.archive.ubuntu.com/ubuntu/ bionic main restricted
universe
###### Ubuntu Update Repos
deb http://am.archive.ubuntu.com/ubuntu/ bionic-security main
restricted universe
deb http://am.archive.ubuntu.com/ubuntu/ bionic-updates main
restricted universe
deb-src http://am.archive.ubuntu.com/ubuntu/ bionic-security main
restricted universe
deb-src http://am.archive.ubuntu.com/ubuntu/ bionic-updates main
restricted universe
Installing Intermapper Using apt-get

On Debian 4.0 or newer Ubuntu systems, you can install Intermapper using apt-get as an
alternative to the manual steps above.

1. Import the Intermapper gpg public key using the following commands:
curl --output dartware_public_key.asc -L
http://www.intermapper.com/go.php?to=gpgkey
sudo apt-key add dartware_public_key.asc
After you import the key, apt remembers it for future releases. You do not need to import
it again.
2. Add the Intermapper repository to apt-get using the following commands:
sudo echo "deb http://download.dartware.com/debian/ ./" >>
/etc/apt/sources.list
sudo apt-get update
sudo apt-get install intermapper
Missing dependencies are automatically resolved and you are notified of new versions of
Intermapper alongside other system updates.
When you upgrade an existing Intermapper installation to a newer version, you do not lose data
in the Intermapper Settings folder. HelpSystems recommends that you create a backup of that
folder before you upgrade, just to be safe. For information on which files to back up, see What is
Installed and Where.

On most Debian and Ubuntu releases, you should be able to upgrade to the 64-bit package in a
similar manner. You can install the upgrade package using the following commands:
cd <directory-containing-deb>
On some versions of Ubuntu, you must remove old 32-bit packages using the following
commands before you install the new 64-bit package:
cd <directory-containing-deb>
sudo dpkg -r intermapper:i386
sudo dpkg -r intermapper-datacenter:i386 #if upgrading from pre-
5.7
When you start the new Intermapper version, it uses the old configuration.
NOTE:
Although Intermapper uses the existing Intermapper Settings directory and the Intermapper
database files, HelpSystems recommends that you back up both of these directories before
you start the upgrade process.


The first time you start the Intermapper server, it accepts only connections from the local
using the following command:
NOTE:
If you cannot run the command above, see Installing Java or Configuring Intermapper
Remotely.

receive data from one exporter (source of NetFlow or sFlow data).
Intermapper Flows is not running by default. For information on starting Intermapper Flows, see
Managing Intermapper Daemons.

Intermapper.

Intermapper components are installed as separate daemons. This means that after you start
them, they automatically start running when your computer starts, before any users are logged
in, and continue running even when no user is logged in. For information on managing the
daemons, see Managing Intermapper Daemons.
l /var/local/InterMapper_Settings/Flows/SESSIONDB - The default directory
for the flow database
l /var/local/InterMapper_Settings/Flows/flows.conf - The configuration file
for Intermapper Flows
l /var/local/InterMapper_Settings/Flows/services - A list of port numbers
and service names
l /usr/local/share/intermapper/imflows_configure.sh - The configuration
script
When Intermapper first starts, the Intermapper_Settings folder is created and is located in
the /var/local/Intermapper_Settings folder. This folder stores preferences, maps, and
data that Intermapper collects from your network. You can change the location of the
Intermapper Settings folder by editing Intermapper's configuration file, which is
/usr/local/etc/intermapperd.conf).
The installer also creates the /usr/local/imdc folder, which contains the DataCenter files,
including data, configuration, and log files.
The following system start-up scripts are also created:
/etc/init.d/imflows
/etc/init.d/imdc
The intermapperauthd file is a setuid-root program. The intermapperd daemon (running as
a non-privileged user) makes requests to intermapperauthd to access low-level network

The installer creates a user called intermapper and a group called intermapper on your system, if
they do not exist already. The new user and group are the owners of the configuration and log
files in the Intermapper Settings and Intermapper DataCenter folders. These log and
configuration files are not granted public read access. If you want to read these files, add yourself
to the intermapper group or use sudo in your commands.




ps acux | grep imdc
Configuring Intermapper Remotely

If your Intermapper server does not have a graphical interface installed, you can use Intermapper
Remote Access to administer the Intermapper server. Before the Intermapper server can accept
connections from Remote Access, launch the server with a command line argument, telling it
where to connect from. Run the following commands* to manually stop the intermapperd process
and restart using the -A option:

sudo /usr/local/bin/intermapperd -f /usr/local/etc/intermapperd.conf -A "remote:password@*.*.*.*"
*For installations that do not have sudo installed, it is not required. The commands must be run as root; the sudo
command can be omitted.
The Intermapper server accepts Administrator connections from any IP address (*.*.*.*) with the
user identifier of remote and the password of password. Launch Intermapper Remote Access on
another computer, log into this new Intermapper system, and set up your Intermapper users and
groups.

Setting a Password for Intermapper DataCenter
Setting a Password for Intermapper

DataCenter
Intermapper DataCenter also requires initial configuration.
The Intermapper DataCenter configuration page, accessed from a browser, requires its own
password.
sudo /usr/local/imdc/sbin/imdc stop

sudo /usr/local/imdc/sbin/imdc --password=[password]
sudo /usr/local/imdc/sbin/imdc start
Now you can connect to Intermapper from one of the following URLs:
l https://localhost:8182/setting.html
l https://IPaddress:8182/setting.html
l https://domain name:8182/setting.html
To remove Intermapper from your system, use the system's graphical package manager or run
the following command:
sudo dpkg -r intermapper
Settings, Intermapper Flows, and Intermapper Datacenter folders or run the following
commands:
sudo dpkg --purge intermapper


Installing Intermapper on Red Hat
Linux Systems
Intermapper is shipped as an RPM package (.rpm file). The Intermapper RPM is signed with gpg to
allow you to verify the integrity of the downloaded file. The yum utility, referenced below,
requires the public key as part of the installation process.
To install the Intermapper gpg public key, run the following commands:
curl --output InterMapper_Key.asc -L http://www.intermapper.com/go.php?to=gpgkey

sudo rpm --import <path_where_public_key_was_saved>/InterMapper_Key.asc
After you import this key, rpm remembers it for future releases and you do not need to import it
again.
To check the signature on the Intermapper package before installing it, run the following
command:
rpm -K "InterMapper-6.5.3-1.x86_64.5x.rpm" #64-bit
If the package signature is correct, the following line is displayed:

InterMapper-6.5.3-1.x86_64.5x.rpm: (sha1) dsa sha1 md5 gpg OK
Installing Intermapper
The Intermapper RPM is available in the following package:
l 64-bit: Intermapper-6.5.3-1.x86_64.5x.rpm - includes 64-bit versions of the Intermapper
server and Intermapper Flows server. These versions allow systems operating near
memory capacity to take advantage of increased memory address space. You can only
install the 64-bit package on a 64-bit release. If you are upgrading from a version previous
to 5.8, uninstall Intermapper as described below before you upgrade. HelpSystems
recommends that you back up your Intermapper Settings directory.

For CentOS, follow the instructions for the compatible version of Red Hat.
sudo yum install "InterMapper-6.5.3-1.x86_64.5x.rpm"

When you upgrade an existing Intermapper installation to a newer version, data from the
Intermapper Settings folder is retained. HelpSystems recommends that you create a backup of
that folder before you upgrade, just to be safe. For information on which files to back up, see
What is Installed and Where.

To upgrade to the 64-bit package, run the following commands:
sudo rpm -Uvh --nopreun InterMapper-6.5.3-1.x86_64.5x.rpm

The first time you start the Intermapper server, it only accepts connections from the local
machine. If you have a graphical interface and Java installed, you can launch Intermapper using
the following command.
NOTE:
If you cannot run the command above, see Installing Java or Configuring Intermapper
Remotely.


receive data from one exporter (NetFlow or sFlow data).
Intermapper Flows does not run by default. For information on starting Intermapper Flows, see
the Managing Intermapper Daemons.

Intermapper components are installed as separate daemons. This means that after you start them,
they automatically start running when your computer starts, before any users are logged in, and
continue running even when no user is logged in. For information on managing these daemons,
see Managing Intermapper Daemons.
l /var/local/InterMapper_Settings/Flows/SESSIONDB - default directory for the
flow database
l /var/local/InterMapper_Settings/Flows/flows.conf - configuration file for
Intermapper Flows
l /var/local/InterMapper_Settings/Flows/services - list of port numbers &
service names
l /usr/local/share/intermapper/imflows_configure.sh
When Intermapper first starts, the Intermapper_Settings folder is created and stored in the
/var/local/Intermapper_Settings folder. This folder stores preferences, maps, and data
that Intermapper collects from your network. You can change the location of the Intermapper
Settings folder by editing the intermapperd.conf file in the /usr/local/etc directory.
The installer also creates the /usr/local/imdc folder that contains Intermapper DataCenter
files, including data, configuration, and log files.
The following system start-up scripts are also created:

/etc/init.d/imflows
/etc/init.d/imdc
The intermapperauthd file is a setuid-root program. The intermapperd daemon (running
as a non-privileged user) makes requests to intermapperauthd to access low-level network
The installer creates the intermapper user and the intermapper group on your system, if they do
not exist already. The new user and group own configuration and log files in the Intermapper
Settings and Intermapper DataCenter folders. These log and configuration files are not granted
public read access. If you want to read these files, add yourself to the intermapper group or use
sudo in your commands.




ps acux | grep imdc
To remove Intermapper from your system, you can use the system's graphical package manager
or run the following command:
sudo rpm -ev InterMapper
Settings, Intermapper Flows, and Intermapper DataCenter folders using the following
commands:



Installing Intermapper Remote
Access
Intermapper Remote Access is packaged as a self-extracting installer, which contains the
necessary programs and support files.
Microsoft Windows Systems

Double-click the Intermapper_RemoteAccess_Setup_6.5.3.exe file and follow the
instructions.
Mac OS X Systems
Double-click the Intermapper_RemoteAccess_6.5.3.dmg file to open the disk image. Drag
the Intermapper Remote Access icon into the Applications folder or onto your Desktop. Double-
click the icon to start Intermapper Remote Access.
Linux Systems
NOTE:
Intermapper Remote Access installs a Java JRE to run the client.
To start the Intermapper Remote Access installer, run the following command:
$ sh ./Install_InterMapper_RemoteAccess_6.5.3.bin
To launch Intermapper Remote Access, run the following commands:
$ cd InterMapper_RemoteAccess_6.5.3
$ ./intermapper_remoteaccess.sh
Alternatively, if you are using a system that supports the freedesktop.org Desktop icon spec, the
installer script should place an icon on your desktop for Intermapper Remote Access. Double-
click the Intermapper Remote Access to start the program.


Uninstalling Intermapper Remote Access
Uninstalling Intermapper Remote Access

Mac OS X Systems
To uninstall Intermapper Remote Access from a Mac OS X system:
1. Open the Applications folder.
2. Drag the Intermapper Remote Access icon to the trash.
3. Manually remove files that have com.dartware.*.plist or com.helpsystems.*.plist in the
file names from the ../Library/Preferences folder.
Microsoft Windows Systems

To uninstall Intermapper Remote Access from a Microsoft Windows system:
1. Open the Control Panel.
2. From Programs and Features, click Intermapper Remote Access.
3. Click Uninstall and follow the prompts.
Linux Systems
Delete the Intermapper_Remote Access_6.5.3 directory and the Intermapper Remote Access
icon from your desktop.

After You Are Done
Congratulations! Intermapper is now installed. Read the following for additional information and
your next steps:
License and Firewall Information

HelpSystems redesigned the licensing mechanism and license key formats. You need a license
key in the new format to run a current version of Intermapper. If you are a customer with a
current maintenance contract, you need to request a new license key. If no valid license key is
found, a License Key Required window is displayed. Click Request a trial license key and
complete and submit the form. Intermapper connects to a web service, retrieves a key, and
inserts it in the Register Intermapper Server window. Click Register to apply the key.
You might need to adjust your firewall settings to allow access from either Intermapper Remote
Access (defaults to TCP port 8181) or your web browser (port 80). You might also need to open
the UDP port 2055 to use Intermapper Flows.
Other Resources
For more information, see the following:
l Intermapper Quick Start Guide
l Intermapper User Guide
l Intermapper DataCenter Tech Note
Contacting Us
For additional resources, or to contact Technical Support, visit the HelpSystems Community
Portal at https://community.helpsystems.com.

Intermapper Installation Guide 6.5.3

Uploaded by

Copyright:

Available Formats

Intermapper Installation Guide 6.5.3

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Intermapper Installation Guide 6.5.3

Uploaded by

Copyright:

Available Formats

Intermapper Installation

Copyright Help/Systems LLC and its group of companies.

Intermapper Installation Guide www.helpsystems.com page: 3

Installing Intermapper on Mac OS X Systems 20

Intermapper Installation Guide www.helpsystems.com page: 4

Intermapper Installation Guide www.helpsystems.com page: 5

Intermapper Installation Guide www.helpsystems.com page: 6

Software Requirements for Intermapper,

Platform Operating System Level

Red Hat Enterprise Linux on x64 systems 7 or 8

Intermapper Installation Guide www.helpsystems.com page: 7

Minimum Hardware Requirements

page: 8 www.helpsystems.com Intermapper Installation Guide

Intermapper Installation Guide www.helpsystems.com page: 9

Intermapper Remote Access

page: 10 www.helpsystems.com Intermapper Installation Guide

What is Installed and Where

Intermapper Installation Guide www.helpsystems.com page: 11

Managing Intermapper Services

Starting Intermapper Flows

page: 12 www.helpsystems.com Intermapper Installation Guide

Intermapper Installation Guide www.helpsystems.com page: 13

Installing From a Command Line

Upgrading From a Command Line

Intermapper Installation Guide www.helpsystems.com page: 14

Installing the Intermapper Public Key

curl --output InterMapper_Key.asc -L

rpm -K "InterMapper-6.5.3-1sse.x86_64.11x.rpm" #64-bit

If the package signature is correct, the following line is displayed:

Java Runtime Environment

Starting Intermapper Flows

page: 15 www.helpsystems.com Intermapper Installation Guide

What is Installed and Where

Intermapper Installation Guide www.helpsystems.com page: 16

l /var/local/InterMapper_Settings/Flows/flows.conf - configuration file for

Managing Intermapper Daemons

sudo /etc/init.d/intermapperd start

sudo /etc/init.d/intermapperd stop

page: 17 www.helpsystems.com Intermapper Installation Guide

ps acux | grep intermapperd

sudo /etc/init.d/intermapperd stop

Setting a Password for Intermapper Data

sudo /usr/local/imdc/sbin/imdc stop

sudo rpm -ev InterMapper

Intermapper Installation Guide www.helpsystems.com page: 18

sudo rm -rf /var/local/InterMapper_Settings

page: 19 www.helpsystems.com Intermapper Installation Guide

Advanced Installation Instructions

sudo installer -pkg "InterMapper-653.pkg" -target /

The --setenv Admin "remote:password@*.*.*.*" option tells Intermapper server to

Upgrading on MacOS X High Sierra

Intermapper Installation Guide www.helpsystems.com page: 20

After you upgrade:

sudo chmod u+s /usr/local/bin/intermapperauthd

What is Installed and Where

page: 21 www.helpsystems.com Intermapper Installation Guide

l /Library/Application Support/InterMapper Settings/Flows/flows_

Managing Intermapper Daemons

# commands to start InterMapper, the DataCenter, and Flows

The --setenv Admin "remote:password@..." option tells Intermapper server to