1. Copy and expand the iPAM distribution

  1. Download the file pam.zip (or file ipam.zip, depending on the current build)
  2. Expand the zip file pam.zip into a directory (these notes assume \iPAM).
  3. The \iPAM directory will now contain serveral directories and files (including .zip files)
    Do not expand the .zip files that came from pam.zip. These are Java run time files.
     

2. Setup the iPAM Startup file (if you have Java 1.1)

  1. Edit \iPAM\ipam.bat file
  2. Edit the command line to properly invoke the Java Runtime Environment (JRE). This .bat file will allow you to execute iPAM from the commandline using the syntax "iPAM <startupfile>". The JRE classpath should include pamStandard.zip and pamCore.zip.
    Example: If you installed JDK 1.1.8 in C:\Program Files\jdk1.1.8 then the correct command line would be:
    c:\Program Files\jdk1.1.8\bin\jre -nojit -cp PAMStandard.zip;PAMCore.zip org.mitre.pam.IPAM %1

     

2. Setup the iPAM Startup file (if you have Java 1.2)

  1. Edit \iPAM\ipam12.bat file
  2. Edit the command line to properly invoke the Java Runtime Environment (JRE). This .bat file will allow you to execute iPAM from the commandline using the syntax "iPAM12 <startupfile>". The JRE classpath should include pamStandard.zip and pamCore.zip.
    Example: If you installed JDK 1.2 in C:\Program files\jre1.2 then the correct command line would be:
    c:\Program Files\jre1.2\bin\java -Djava.compiler=NONE -Djava.security.policy=iPAM.policy -cp PAMCore.zip;PAMStandard.zip org.mitre.pam.IPAM %1

3. Configure iPAM

Using the Wizard (first time iPAM is run)

  1. Run iPAM from the command line with no arguments. iPAM will display a startup wizard that will help you configure your initial startup.
    1. Open a command-line window.
      Change the default directory to the root of the iPAM installation.  You must do this because iPAM looks for several directories and support files at runtime relative to the current working directory.
      Type "ipam" (or "ipam12" depending on Step 2 above)
  2. Fill in the information requested by the wizard.
    1. You can edit the file 0checkpts\ckpt.txt later if you need to change any of this information
  3. iPAM is now running.  If you allowed the wizard to create a test configuration you will shortly see an output window popup.  You can now access the Bert user interface from the Toolpicker window to edit your configuration and build new "channels"

Using Bert

Bert (Block Editing and Reconfiguration Tool) is a way to build and edit data channels.  Bert is accessible from the Toolpicker window.  However, Bert does not allow you to create Daemons.  To create Daemons you must use a text editor to edit the startup file.  See checkpoint files.

Manually

There are several examples of checkpoint/startup files in the directory 0checkpts\examples. You can use a text editor to manually create or modify your configuration. However, it is best to use Bert to edit your configuration and build channels.

If you create your configuration with a text editor note that the following exec parameters are vital:

(proxyHost x.y.z)(proxyPort nn)
proxyHost and proxyPort define your site's firewall proxy. If you have no firewall then delete these two parameters, including the enclosing parenthesis.

 
(serverPortNumber 19090)
defines an admin port for use by iPAM. Make sure it does not conflict with other port assignments on your machine.
(protocolAndHost http://your.host.addr)
If you copy a checkpoint file to another host you must be sure to change this
(peerProtocolHostAndPort http://littlefoot.home.home:19090)
This port number may be the same as the serverPortNumber above. Alternatively if you have a conventional web server running it may be the port number used by that web server.  This requires you to set up a peer web server.
  Revised 16 march 2000