/
ColdCore-3.0a9.02/
ColdCore-3.0a9.02/src/
BEFORE YOU INSTALL
------------------

You will need a current version of Genesis to use ColdCore-3.0a9.02.
Information on getting the latest Genesis can be found at:

    http://www.cold.org/Software/Genesis/

INSTALLING
----------

Once you have Genesis compiled, locate the programs 'coldcc' and
'genesis' (created from the Genesis distribution) and move them to
this directory.  Then type:

       tdjoin
       coldcc

NOTE: tdjoin requires PERL version 5.002 or greater.  If you do not
have this and you are not able to install it on your system, you can
still merge your textdump.  Read the section HAND GENERATING A TEXTDUMP
at the end of this document.

If there are no problems, running the above two commands will generate
an initial textdump from the files in the 'src' directory and compile
it to a binary database.  You will need to setup the base directories
genesis prefers (see the Genesis Documentation for more details).  To
create the directories it prefers, simply type:

       mkdir logs
       mkdir root
       mkdir dbbin

STARTING FOR THE FIRST TIME
---------------------------

The first people to create accounts will be creating administrative
accounts, and will be placed into a configuration subsystem.  Therefore,
it is in your best interest to start the server and connect alone
first, then after you finish the configuration you can invite others
to connect.

You can start your server at any time by typing:

       genesis

This will create a daemon process in the background.  You can now
connect to your server through port 1138, or on the web through
port 1180.

SUPPORT THE COLD PROJECT
------------------------

You can learn more about helping to support the Cold Project at:

    http://www.cold.org/support/

HAND GENERATING A TEXTDUMP
--------------------------

If you cannot find or install PERL 5.002 or greater, you can still
generate your own textdump.  Simply run the following in a Bourne
Shell interpreter (i.e. /bin/sh):

    for file in `cat src/+CORE src/+INDEX`; do
        echo "${file}.."
        cat src/${file}.cdc >> textdump
    done