InterMapper for Debian Linux is packaged as a "Debian Package", which contains the necessary programs and support files. To install InterMapper from the .deb file, you will use the dpkg --install "location" command. To query if InterMapper is already installed, type dpkg --list intermapper. To remove InterMapper from your system after installing it, type dpkg --remove intermapper. After you remove the package, you can get rid of any old configuration files using dpkg --purge intermapper.
The following directions will install InterMapper from the Debian package. InterMapper Server will be configured to run at startup. You may need to install libstdc++5 first; there is no harm in attempting to install it a second time.
Ubuntu instructions:
Debian systems newer than Debian 3.1 or Ubuntu systems may alternatively install InterMapper via apt-get or similar tools. To do this, add deb http://download.dartware.com/debian/ ./ to the list in /etc/apt/sources.list.
On Debian 4.0 and newer systems, you may also install our gpg public key to verify the package information files downloaded by apt-get. To do this, run the following commands:
Ubuntu instructions:
Once you have imported this key, apt will remember it for future releases and you will not need to import it again. apt-get (and synaptic, aptitude, adept, etc.) will automatically use this key to verify the checksums of the package lists it downloads.
Ubuntu instructions:
Installing this way will automatically resolve any missing dependencies, including the libstdc++5 dependency. Additionally, any updates to InterMapper will be flagged along with any other system updates; if you are running an update notifier program (one is installed by default on Ubuntu systems), you will be notified of InterMapper updates in the same manner and place as other system updates.
If you are going to run InterMapper console on this system, you will also need to install Java. Debian 4.0 (etch) and higher users may easily install Java 5 from the non-free repository:
Ubuntu 7.04 (feisty fawn) and higher users may easily install Java from the multiverse repository:
When InterMapper Server begins running, it can run under any uid on your system. You may specify the user name to run as in the intermapperd.conf file, located at /usr/local/etc/intermapperd.conf By default, the InterMapper package creates a system user named 'intermapper' and sets the configuration file to use that user.
The InterMapper Server is now installed and running. By default, it will save its files in the /var/local/InterMapper_Settings/ directory, though you may change this in /usr/local/etc/intermapperd.conf. To manually start the server, type:
Ubuntu instructions:
If the server started successfully, you will see the startup message:
To stop the server, use the similar "stop" command:
Ubuntu instructions:
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 Console by typing:
The InterMapper Console is also available in the Gnome menu, under Applications > System Tools > InterMapper, or in the KDE menu, under K > System > InterMapper.
If you do not have a window system, you must use "InterMapper Remote" to administer the InterMapper Server. Before the server will accept connections from Remote, 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:
Ubuntu instructions:
The InterMapper server will now accept Administrator connections from any IP address (*.*.*.*) with the user ID "remote" and the password "password". You should immediately launch InterMapper Remote on another computer and login to this new InterMapper system to set up your InterMapper users and groups.
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 "dpkg --remove". 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.
Ubuntu instructions
Beginning with InterMapper 4.6b2, this should no longer be necessary; you may simply install the newer version without removing the earlier version.
Ubuntu instructions
If you have configured the repository as above, you will only need to use apt-get as you would for any other system update.
Ubuntu instructions
To remove InterMapper Server, you will use the "dpkg --purge" command. The "dpkg --purge" command will not remove any files created by InterMapper, such as those stored in your "InterMapper_Settings" directory. To completely remove all remnants of the software, you must also locate and remove the "InterMapper_Settings" directory. By default, the "InterMapper_Settings" directory is located in /var/local/.
Ubuntu instructions: