The following steps are necessary to install NetForge. The examples assume
that you have a copy of Sun's JDK or JRE (version 1.1 or better) already
installed. Installation on other platforms may differ in some points.

When updating an existing NetForge installation, be sure to read the
version history in the HISTORY file. You need to delete old configuration
files before updating from a version earlier than 0.40.

1. Unpack the NetForge distribution archive at a place of your preference.
   Since you are reading this you probably have done that already.

   Example:
     $ cd /usr/local
     $ gzip -d netforge-x.y.tar.gz
     $ tar xf netforge-x.y.tar

2. Start the server. The supplied shell script "netforge/bin/netforge" should
   work on most Unix-style systems. If you can't or don't want to use that
   script, you can also start the server by calling a JVM directly. In that
   case be sure to set the home directory via the --home option (see below)
   to the directory in which NetForge was installed.

   NetForge accepts the following command line options:

     --help (-h)
       Display a list of the command line options and their current default
       values and exit.

     --version (-V)
       Display the Version of NetForge and the used class libraries and exit.

     --home=STRING (-d)
       The home directory of the server. The supplied "netforge" script sets
       this to the top-level directory of the NetForge installation. The
       default is the subdirectory "netforge" in the user's home directory.

     --conf=STRING (-c)
       The directory in which NetForge stores configuration files. The
       default is the subdirectory "conf" of the home directory.

     --initial-gui (-i)
       Open a local configuration GUI on the server machine when the server
       is started. Deactivated by default.

     --admin-server
       Activate the admin server. Deactivated by default.

     --admin-server-port=INT
       The port for the admin server. Overrides the configured value.

     --popup-hack
       Set the system property "metaconf.awt.popuphack". If set to true,
       the administration GUI opens popup menus when the right mouse button
       is pressed instead of relying on the isPopupTrigger() method.
       If isPopupTrigger() is broken on your platform and you don't see any
       popup menus in the server tree view, try using this option.
       Deactivated by default.

   Example (with script):
     $ /usr/local/netforge/bin/netforge -i

   Example (without script, Unix environment):
     $ java -classpath $CLASSPATH:/usr/local/netforge/classes:\
       /usr/local/netforge/lib/netforge.jar:\
       /usr/local/netforge/lib/tk.jar:\
       /usr/local/netforge/lib/servlet.jar:\
       /usr/local/netforge/lib/metaconf.jar \
       novocode.netforge.StandaloneLauncher -d /usr/local/netforge -i

   Example (without script, Windows environment):
     $ java -classpath %CLASSPATH%;C:\netforge\classes;\
       C:\netforge\lib\netforge.jar;\
       C:\netforge\lib\tk.jar;\
       C:\netforge\lib\servlet.jar;\
       C:\netforge\lib\metaconf.jar \
       novocode.netforge.StandaloneLauncher -d C:\netforge -i

   (A '\' character at the end of a line indicates a continued line. Don't
   type the '\', the following linefeed or the whitespace characters at the
   beginning of the next line.)

3. Direct your web browser to the example web server on port 22722.

   Example:
     $ netscape http://localhost:22722

   The admin server is protected by a BasicRealm. You can log in as user
   "admin" with the password "admin".

   There is also a GUI administration tool which can be opened by starting
   NetForge with the --initial-gui option or by selecting "Open
   administration GUI on server machine" on the "System" configuration page.

   The first thing you should do when configuring NetForge is to change the
   administration password in the protection space "NetForge Administration".

4. Read the documentation which was installed in "netforge/doc/", starting
   with the file "index.html".

   Example:
     $ netscape file:/usr/local/netforge/doc/index.html