
Refer to the general README file to learn how paths
and filenames are used in this documentation. 

WINDOWS INSTALLATION
====================

Double-click on the file 'miningmart-1.1.exe' and
the installer will guide you through the process.

After installing, you can run the program by going
to Start -> Programs -> MiningMart-1.1 -> StartMiningMart
or by double-clicking on the file
MM_HOME\bin\startMM.bat.

LINUX INSTALLATION:
===================

Steps to undertake before MiningMart can be started
---------------------------------------------------

0. You ought to read the README file.

1. You must have JAVA installed on your system. MiningMart is 
   tested for Java 1.4 and 1.5. For more information see
   http://java.sun.com

2. Your Oracle, Postgres, or MySql installation provides a JDBC
   driver. This is a file which a Java program can use to read and
   write from the database. Your Oracle, Postgres or MySql
   documentation will tell you where to find the file. The Oracle file
   is often called 'ojdbc14.jar', 'classes13.jar', 'classes12.zip' or 
   similar. The Postgres file is usually called
   'postgresql.jar' and the MySql file should be called 
   'mysql-connector-version-bin.jar' or similar.
   
   As an Oracle user, please place a copy of that file into
   MM\_HOME/lib/. If you are using Linux or Solaris, that's it.  If you
   are using Windows and have not chosen this file during installation,
   you may now have to edit one line in the file 
   MM\_HOME\bin\mmart.bat. Add one line like the following to this
   file, near the line that starts with 'set POSTGR=...',
   or update the existing line: 
   set ORA=%MMART_HOME%\lib\classes12.zip 
   Adapt the file name to your Oracle JDBC file.
   
   If you are going to use postgres: A Postgres JDBC file is already
   provided in MM\_HOME/lib/ under the license described in 
   MM_HOME/licenses/LICENSE_POSTGRESQL_JDBC. However, you may
   still have to find the JDBC file that belongs to your own Postgres
   installation if you are experiencing troubles (particularly for
   Postgres versions 8.x or higher). Just copy the file to 
     MM\_HOME/lib/. If you are using Linux or Solaris, that's it. If
   you are using Windows, you may now have to edit one line in the
   file MM\_HOME\bin\mmart.bat: you will find the line 
   
   set POSTGR=%MMART_HOME%\lib\postgresql.jar
   
   in this file. Change the line so that the file name is correct, ie
   matches the Postgres JDBC driver file name.

   For MySql the procedure is the same as for Postgres; a JDBC file is
   already provided, which has been tested for MySql version 5.0. If
   you are going to use a higher version of MySql, you may also have
   to use a later version of the JDBC file. Please proceed as
   described above for Postgres in order to let MiningMart use your
   JDBC file.
   
3. Open and edit the file MM_HOME/bin/mmart.sh. Follow the 
   instructions given in comments in that file: there is only one
   obligatory line to edit. The line looks like this before you
   have changed it:
   
   MMART_HOME= 
   
   After you have changed it, it should look something like this:
   
   MMART_HOME=/home/myname/analysis/MiningMart-1.1/
           
   Save the edited version of the file under the same name.
   
4. Make sure that the file mentioned in step 3 is executable. Under
   Linux or Solaris the command "chmod u+x mmart.sh" will ensure 
   this. Under Windows, right-click on the file and change its 
   properties.
   
5. That's all. You can now run MiningMart by issuing the command
   "./mmart.sh &" from the MM_HOME/bin directory.
   
