InterMapper for FreeBSD is packaged as a "BSD PACKAGE" file, which contains the necessary programs and support files. To install InterMapper from the package, you will use the pkg_add "location" command. To query if InterMapper is already installed, type pkg_info | grep InterMapper. To remove InterMapper from your system after installing it, type pkg_delete InterMapper-5.0.6.
Note: The graphical user interface programs (InterMapper or InterMapper RemoteAccess) require Sun Java Runtime Environment. For more information on how to install Java on FreeBSD, please visit: http://www.freebsd.org/java/install.html.
The following directions will install InterMapper from the package. InterMapper Server will be configured to run at startup.
When InterMapper Server begins running, it can run under any uid on your system. By default, the package creates a user named 'intermapper' to run as. You may specify the user name to run as in the intermapperd.conf file, located at /usr/local/etc/intermapperd.conf.
By default, InterMapper Server will save its files in /usr/local/share/intermapper/InterMapper_Settings/; you may change this by editing the SettingsFolder in /usr/local/etc/intermapperd.conf.
To manually start the server, type:
If the server started successfully, you will see this cryptic message with no newline following it:
To stop the server, use the similar "stop" command:
The first time you start the InterMapper Server, it will only accept "control" connections from the local machine. If you have a window system (ie X-Windows) and JVM already installed, you can launch InterMapper by typing:
To upgrade your InterMapper installation to a newer version, you will "erase and re-install". Your InterMapper settings directory, which includes all of your maps, logs, and notification settings, is not removed when you un-install using "pkg_delete". Although you will not lose any data during the re-installation, this might still be a good time to make a backup of the InterMapper settings folder.
After you re-install InterMapper, you will need to restart the server by following the directions above.
Before the server will accept connections from RemoteAccess, you must launch the server with a command-line argument telling it where you will connect from. Type the following commands to kill the intermapperd process, then restart it manually using the -A option:
To remove InterMapper Server, you will use the "pkg_delete" command. The "pkg_delete" command will not remove any files created by InterMapper, such as those stored in your "InterMapper_Settings" directory. It will also leave the intermapperd.conf file untouched. To completely remove all remnants of the software, you must also locate and remove the "InterMapper_Settings" directory and the intermapperd.conf file.
InterMapper for FreeBSD is compiled on a 5.x release of FreeBSD. To run InterMapper on a FreeBSD 6.x system, you must have the 5x compatibility libraries installed on your 6x system. These libraries are part of the compat5x package. If you install a minimal system, these libraries may not installed by default.
A symptom of this problem is that intermapperd will complain that the following libraries are not available:
To fix this issue, install the compat5x package using pkg_add:
As an alternative, you can also use the ports system to install compat5x. You must restart the computer after installing this port:
After installing the compat5x package, use the 'ldd' command to verify that all of the required libraries exist: