|
|
InterMapper for Debian or Ubuntu Linux is packaged as a "Debian Package", which contains the necessary programs and support files. To install InterMapper from the .deb file, 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, and removing the settings directory, generally in /var/local/InterMapper_Settings.
The following directions install InterMapper from the Debian package. InterMapper Server will be configured to run at startup. If you are running an older Debian or Ubuntu release, you may need to install libstdc++6 first (all currently supported releases of Debian, Ubuntu, and derived systems already have libstdc++6 installed); there is no harm in attempting to install it a second time.
|
Debian Instructions
$ /bin/su -
# cd <directory-containing-deb> # dpkg --install "intermapper_5.5.4-1_i386.deb" |
Ubuntu instructions
$ cd <directory-containing-deb>
$ sudo dpkg --install "intermapper_5.5.4-1_i386.deb" |
The InterMapper package will install and run on a 64-bit version of Debian or Ubuntu, provided that two additional changes are made. The first is that the ia32-libs package must also be installed:
|
Debian Instructions
$ /bin/su -
# apt-get install ia32-libs |
Ubuntu instructions
$ sudo apt-get install ia32-libs
|
The other is that an additional flag must be passed to dpkg during installation, which means that InterMapper must be installed via the command line (the instructions below for using the repository and apt-get do not apply).
|
Debian Instructions
$ /bin/su -
# cd <directory-containing-deb> # dpkg --force-architecture --install "intermapper_5.5.4-1_i386.deb" |
Ubuntu instructions
$ cd <directory-containing-deb>
$ sudo dpkg --force-architecture --install "intermapper_5.5.4-1_i386.deb" |
On Debian 4.0 and newer 32-bit Debian systems or newer Ubuntu systems, you may install InterMapper via apt-get or similar tools as an alternative to the manual steps above. To do this, first import the Dartware gpg public key, then add deb http://download.dartware.com/debian/ ./ to the list in /etc/apt/sources.list.
Import the Dartware gpg public key to verify the package information files downloaded by apt-get. To do this, run the following commands:
|
Debian Instructions
$ curl -O http://download.dartware.com/debian/dartware_public_key.asc
$ su - # apt-key add <path-to-dartware_public_key.asc>/dartware_public_key.asc |
Ubuntu instructions
$ curl -O http://download.dartware.com/debian/dartware_public_key.asc
$ sudo apt-key add ./dartware_public_key.asc |
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.
|
Debian Instructions
$ su -
# echo "deb http://download.dartware.com/debian/ ./" >> /etc/apt/sources.list # apt-get update # apt-get install intermapper |
Ubuntu instructions
$ echo "deb http://download.dartware.com/debian/ ./" | sudo tee -a /etc/apt/sources.list
$ sudo apt-get update $ sudo apt-get install intermapper |
Installing this way will automatically resolve any missing dependencies. 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 the InterMapper GUI 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 users (7.04 (feisty fawn) and higher) may easily install Java from the multiverse repository (As of Ubuntu 10.04, Java has moved to the "partner" respository).
|
Debian Instructions
$edit /etc/apt/sources.list, to add
"non-free" to your repositories $ su - # sudo apt-get install sun-java5-jre |
Ubuntu instructions
$ sudo apt-get install sun-java6-jre
|
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:
|
Debian Instructions
$ su -
# /etc/init.d/intermapperd start |
Ubuntu instructions
$ sudo /etc/init.d/intermapperd start
|
If the server started successfully, you will see the startup message:
To stop the server, use the similar "stop" command:
|
Debian Instructions
$ su -
# /etc/init.d/intermapperd stop |
Ubuntu instructions
$ sudo /etc/init.d/intermapperd stop
|
If you have a window system (ie X-Windows) and JVM already installed, the InterMapper GUI program is available in the Gnome menu, under Applications > System Tools > InterMapper, or in the KDE menu, under K > System > InterMapper. You can also launch the InterMapper GUI by typing:
The first time you start the InterMapper Server, it will only accept GUI connections from the local machine. If you do not have a window system installed, you must use InterMapper RemoteAccess on another computer to administer the InterMapper Server. Before the server will accept connections from RemoteAccess, you must launch the server with a command-line argument telling where you will connect from. Type the following commands to kill the intermapperd process, then restart it manually using the -A option:
Debian InstructionsThe 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 RemoteAccess 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 should first create a backup of your InterMapper_Settings directory, then install with dpkg or apt-get. By default, the InterMapper_Settings directory is in /var/local/InterMapper_Settings/
|
Debian Instructions
$make backup of InterMapper_Settings directory
$ /bin/su - # cd <directory-containing-deb> # dpkg --install "intermapper_5.5.4-1_i386.deb" |
Ubuntu instructions
$make backup of InterMapper_Settings directory
$ cd <directory-containing-deb> $ sudo dpkg --install "intermapper_5.5.4-1_i386.deb" |
Using apt-get: If you have configured the repository as above, you will only need to use apt-get as you would for any other system update.
|
Debian Instructions
$make backup of InterMapper_Settings directory
$ su - # apt-get update # apt-get upgrade |
Ubuntu instructions
$make backup of InterMapper_Settings directory
$ sudo apt-get update $ sudo apt-get upgrade |
NB: InterMapper 4.6 and earlier required you to erase and re-install using dpkg --remove intermapper and then dpkg --install ... This is no longer necessary with more recent versions of InterMapper.
To remove InterMapper Server, use the dpkg --purge command. This 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/.
|
Debian Instructions
$ /bin/su -
# dpkg --purge intermapper # rm -rf /var/local/InterMapper_Settings # deluser intermapper |
Ubuntu instructions
$ sudo dpkg --purge intermapper
$ sudo rm -rf /var/local/InterMapper_Settings $ sudo deluser intermapper |
There is a bug when using Java with Compiz or certain other window managers that affects InterMapper, resulting in blank windows when starting either the InterMapper GUI or InterMapper RemoteAccess. This bug has been mitigated somewhat by Java 6 Update 1, but problems still remain. As a work-around, you can set the AWT_TOOLKIT environment variable to "MToolkit" prior to starting the InterMapper GUI. This tells Java to revert to an older rendering method, which will not integrate as well with modern desktop environments, but doesn't suffer from the same bug.
If you wish to set this option for future sessions, add the following line to ~/.bashrc:
Any new terminal windows that you open will have this setting in them by default as soon as you have run this command, but applications started from the menu will not pick it up until after you log out and log back in again. This will work for all Java applications on your system (which were probably similarly broken), not just InterMapper.
Copyright © 2007-2012, Dartware, LLC.