Installing Intermapper on macOS Systems

Running Intermapper on a macOS virtual machine is not supported.

Before you start, download the installer to a convenient location. If you are a current user, access the download from the Fortra website (https://community.fortra.com). If you are a new customer, use the link in email you received to download Intermapper.

1. Double-click the .dmg installer file to open the disk image.
2. Double-click the Intermapper-6.6.3.pkg file and follow the instructions. You must be an Administrator to install this software.
3. When the installer finishes, it launches the Intermapper client to view and configure your Intermapper server.

Installing from the command line

1. Log on as root user.

2. Identify the disk image (*.dmg) file containing the Intermapper Combined Installer distribution. Use the hdiutil command to mount the disk image.

3. Invoke the macOS command installer (found at path /usr/sbin/installer) on the package (*.dpkg) file that is visible below the mount point for the newly mounted disk image. Use the target option to specify the root directory (/) as the destination for the installation process.

4. After completing the installation process, you can then unmount the disk image.

   Copy

   # hdiutil mount "/Users/user/Downloads/InterMapper-6.6.3.dmg"
   /dev/disk3 GUID_partition_scheme
   /dev/disk3s1 Apple_HFS /Volumes/InterMapper-6.6.3
   # installer -package "/Volumes/InterMapper-6.6.3/InterMapper-6.6.3.pkg" -target /
   . . .
   # hdiutil unmount "/Volumes/InterMapper-6.6.3"
   "/Volumes/InterMapper-6.6.3" unmounted successfully.

5. To launch the Intermapper client, double-click on the InterMapper icon in the Applications folder. From that interface you can now continue to view and configure your Intermapper server.

If you are upgrading the Intermapper Combined Installer from the command line, then the procedure is similar. The macOS command installer will, when invoked with the appropriate values for the package file and destination path (-target /), infer that an upgrade installation desired and will upgrade from the old version of Intermapper to the new version as part of the process of installing the new package.

What is installed and where

Intermapper components are installed as separate macOS services. 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 services, see Managing Intermapper Services. The installer creates the following files and folders:

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 /opt/helpsystems/intermapper/imdc folder that contains the core IMDC files, including configuration and log files.

For macOS 10.7 and higher, the following installation files are created:

- /var/db/receipts/com.dartware.InterMapperPkg.bom
- /var/db/receipts/com.dartware.InterMapperPkg.plist

The following system start-up configuration files are also created:

- /Library/LaunchDaemons/com.dartware.InterMapperServer.plist
- /Library/LaunchDaemons/com.dartware.InterMapperDataCenter.plist
- /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 Managing Intermapper Services. 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.

Upgrading on MacOS X High Sierra Systems

Before you upgrade:

1. Back up your Intermapper Settings folder.

2. Uninstall Intermapper using the following command:

    

Copy

sudo /usr/local/share/intermapper/Uninstaller.sh

3. Remove the Intermapper user and group using the following commands:

   Copy

   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

Managing Intermapper Services

You can start and stop Intermapper services with the Intermapper Control Center, available on the right side of the macOS menu bar. The Intermapper and Intermapper DataCenter services are started and stopped simultaneously. You can also manually start individual services using the following commands:

sudo /usr/local/share/intermapper/Start.sh
sudo /usr/local/share/intermapper/Start.sh imdc
sudo /usr/local/share/intermapper/Start.sh imflows

You can manually stop individual services using the following commands:

sudo /usr/local/share/intermapper/Stop.sh
sudo /usr/local/share/intermapper Stop.sh imdc
sudo /usr/local/share/intermapper/Stop.sh imflows

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:

/usr/local/bin/intermapperd -v

To check if Intermapper services are currently running, run the following commands:

ps acux | grep intermapperd
ps acux | grep intermapperflows 
ps acux | grep imdc

Starting Intermapper Flows

Intermapper Flows Intermapper Flows is installed automatically with Intermapper. It allows you to obtain deeper insight into the traffic on your network. 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 run by default. Use the Intermapper Control Center to start it to access flows information.

Consider the following before starting Intermapper Flows:

• If you are running a trial version, Intermapper Flows is fully operational. After your trial expires, an Intermapper Flows license is required.
• Remove any firewalls on the selected UDP ports for NetFlow. The default port is 2055.
  
  NOTE: The Intermapper Flows service/daemon might not start if another program is using port 2055 (or whatever port you have designated for netflow packets). Stop or uninstall other netflow packages on the system.

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 RemoteAccess. 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).

See the Intermapper User Guide or online help for more information on Intermapper Flows.

Intermapper Data Center

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 go to the DataCenter web interface. You can select the certificate and safely continue to navigate to the page. The Intermapper DataCenter Settings page allows you to upload your own certificate rather than relying on the less secure certificate shipped with Intermapper.

Uninstalling Intermapper

To remove Intermapper from your system, run the following command:

sudo /usr/local/share/intermapper/Uninstaller.sh

When you uninstall Intermapper, the settings and data files are not removed. If you do not plan on reinstalling Intermapper and want to remove it completely, manually remove the InterMapper Settings, Intermapper Flows, and Intermapper DataCenter folders using the following commands:

sudo rm -rf "/Library/Application Support/InterMapper Settings"
sudo rm -rf /usr/local/imdc

Installing Remote Access

To install Intermapper RemoteAccess:

Double-click the Intermapper_RemoteAccess_6.6.3.dmg file to open the disk image. Drag the Intermapper RemoteAccess icon into the Applications folder or onto your Desktop. Double-click the icon to start Intermapper RemoteAccess.

If your Intermapper server does not have a graphical interface, use Intermapper RemoteAccess 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 intermapper, grant remote access to the server, and restart Intermapper:

sudo /usr/local/share/intermapper/Stop.sh
sudo /usr/local/bin/intermapperd -f /usr/local/etc/intermapperd.conf --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 RemoteAccess 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.

The Linux Intermpper RemoteAccess package (a self-extracting installer) does not deliver a Java JRE: it will attempt to use the JRE supplied with an Intermapper Server installation on the same host, or, failing that, a Java Runtime from the host environment.

To start the Intermapper RemoteAccess installer, run the following command:

$ sh ./Install_InterMapper_RemoteAccess_.bin

To launch Intermapper RemoteAccess, run the following commands:

$ cd InterMapper_RemoteAccess_
$ ./intermapper_remoteaccess.sh

If your Intermapper server does not have a graphical interface, use Intermapper RemoteAccess 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, grant remote access to the server, and restart the intermapperd process:

sudo systemctl stop intermapperd.service
sudo /opt/helpsystems/intermapper/bin/intermapperd -f /usr/local/etc/intermapperd.conf --setenv 'Admin=remote:password@*.*.*.*'
sudo systemctl start intermapperd.service

The Intermapper RemoteAccess package includes and installs a compatible JRE which runs the Intermapper client.

Silent installation with an ISS file

To silently install Intermapper Remote Access, you must create and use an ISS file.

1. Launch the following as an Administrator from a command line or from a script:

   Copy

   InterMapper_RemoteAccess_Setup_663.exe /s /a /r /f1"c:\temp\imra_setup.iss"

2. Continue with the rest of the installation.

   Ensure you click the agreement when you run the command and finish the installation.

3. Confirm imra_setup.iss is in the specified folder.

   Intermapper will launch as soon as it is installed.

For subsequent installations

Run the following command:

@set NOLAUNCHIM=1
InterMapper_RemoteAccess_Setup_663.exe /s /a /SMS /f1"c:\temp\imra_setup.iss"

Uninstalling Remote Access

To uninstall Intermapper RemoteAccess from a macOS system:

1. Open the Applications folder.
2. Drag the Intermapper RemoteAccess 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.

Delete the Intermapper_Remote Access_6.6.3 directory and the Intermapper RemoteAccess icon from your desktop.

To uninstall Intermapper RemoteAccess from a Microsoft Windows system:

1. Open the Control Panel.
2. From Programs and Features, click Intermapper RemoteAccess.
3. Click Uninstall and follow the prompts.