######################################################################
#        The MiningMart system - V0.2 - released 2003-12-01          #
######################################################################

Please kindly understand that we offer the software with absolutely no
warranties!

The copyright of all the software is owned by the MiningMart
partners. The software is free for research, non-profit applications,
and in-house use by companies, only!

Contact: mmcoord@ls8.cs.uni-dortmund.de

######################################################################

Installing the system:

As a prerequisite you need to prepare two database users on your
Oracle database. To get the full functionality you need at least
Oracle 8.1.6 and support for Java stored procedures should be enabled.

Before running the MiningMart application you need to prepare
* the meta-data tables for the M4 user and
* all functions and stored procedures for the business data user.

I. Preparing the database

For this purpose there is a script "install.sh/install.bat" in the
directory "M4". Please set user, password, database host, and specify
how to run "sqlplus" and "loadjava" on your machine. These settings
need to be entered directly into the script. After that you can run the
script. You may delete the folder "M4" afterwards.

II. Libraries

The database driver (e.g. the file classes12.zip part of your Oracle
distribution) needs to be copied (or symbolically linked if supported
by your OS) to the directory "lib" before proceeding.

To complete the system you need to download two JAR-files (GraphView
and HotDraw) and place them in the lib/ sub-directory. You may want
to also add some binary Machine Learning tools. Please refer to the
file PLUGINS on what is currently supported on your platform, how to
get the binaries, and where to put them.

III. Running the system

To start MiningMart there is a script "mmart.sh" for Unix/Linux and
"mmart.bat" for Windows in the directory "MiningMart/bin". Before
calling this script please make sure Java (recommended version: at
least 1.4.2) is available on your system.

Edit the file mmart.sh or mmart.bat:
* If Java cannot be started from a command line by typing in "java",
  then specify the command to be used instead.
* The variable MM_HOME needs to point to the top-level directory
  "MiningMart".
* The variable MM_LOCAL_HOME should point to a directory where you
  have write access to. On Unix/Linux the default MM_LOCAL_HOME is
  ~/.mmart, which should be fine on most machines. On Windows
  machines there is no default setting, so you have to set this
  variable manually.

Now you should be able to run the system with mmart.sh or mmart.bat !

######################################################################







