InterMapper for Solaris is packaged as a "Sun Package" named "DARTinter", which contains the necessary programs and support files. To install the package "DARTinter", you will use the pkgadd -d "location" command. To query if InterMapper is already installed, type pkginfo -l DARTinter. To remove InterMapper from your system after installing it, type pkgrm DARTinter.
The following directions will install InterMapper from the package. InterMapper Server will be configured to run at startup:
You will see the following prompt. Press return to continue:
After this, you may also see the following prompt. Type y and press return:
Finally, you may also see the following prompt. Type y and press return:
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 package's postinstall script will create a user named 'intermap' and set 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/lib/intermapper/InterMapper_Settings/ directory. To manually start the server, type:
If the server started successfully, you will see the startup message:
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 Console by typing:
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:
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 InterMapper while retaining your current settings, you will perform a four-step procedure:
Your custom maps, logs, and the other files stored in the 'InterMapper_Settings' directory are not affected by removing InterMapper. However, the intermapped.conf file will revert to its default contents when the new version is installed; hence, you will need to preserve any modifications to this file.
The IM_UPGRADE.sh shell script will automate the upgrade process for you. To use it, enter the directory containing the new Solaris package and type:
When the script begins to install the new package, you will be prompted to answer 'y', just as described above.
To remove InterMapper Server, you will use the "pkgrm" command. The "pkgrm" 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.
Here is the source code for the IM_UPGRADE.sh utility script. This script automates the InterMapper upgrade process on Solaris.
#!/bin/sh
# Shell script to upgrade an InterMapper Server installation on Solaris.
set -e
if [ -z "$1" ]; then
echo "Usage: sh IM_UPGRADE.sh 'package-file'"
echo "Please specify the package file to install as the first argument."
exit 1
fi
pkg_name="$1"
if [ ! -f "${pkg_name}" ]; then
echo "ERROR: File '${pkg_name}' does not exist."
exit 1
fi
echo "\nUpgrading your installation of 'DARTinter'."
echo "Your current configuration will be preserved.\n"
conf="/usr/local/etc/intermapperd.conf"
conf_bak="/tmp/intermapperd.$$.conf"
cp "${conf}" "${conf_bak}"
pkgrm DARTinter
pkgadd -d "${pkg_name}"
mv -f "${conf_bak}" "${conf}"
echo "Done."
exit 0