forked from m4dc4p/haskelldb
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
added INSTALL file (only requirements and HSQL setup so far)
darcs-hash:20040106192711-cca28-1f4f4c333fe47d6b17c8fbfca53e5d85d025678f.gz
- Loading branch information
d00bring
committed
Jan 6, 2004
1 parent
4cbec8d
commit b0b369b
Showing
1 changed file
with
13 additions
and
131 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,137 +1,19 @@ | ||
Installation with Cabal: | ||
|
||
- Install the main package (haskelldb): | ||
|
||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
|
||
- Install the hs-plugins backend which loads drivers | ||
dynamically (requires at least the current, as of | ||
2005-12-09, darcs version of hs-plugins): | ||
|
||
cd driver-dynamic | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
- Compile and install DBDirect: | ||
|
||
make | ||
make install | ||
|
||
- Install HSQL drivers (you need driver-hsql and | ||
the backends you want to use): | ||
|
||
cd driver-hsql | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
cd driver-hsql-mysql | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
cd driver-hsql-postgresql | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
cd driver-hsql-odbc | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
cd driver-hsql-sqlite | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
- Install the WXHaskell driver: | ||
|
||
cd driver-wx | ||
./Setup.hs configure | ||
./Setup.hs build | ||
./Setup.hs install | ||
cd .. | ||
|
||
|
||
|
||
|
||
Requirements: | ||
|
||
- GHC 6.4 or newer (if you want GHC support) | ||
|
||
- GNU Make | ||
|
||
- Hugs ??? HaskellDB used to work with Hugs, does it still? | ||
|
||
A database driver, at least one of: | ||
|
||
- HSQL (http://htoolkit.sourceforge.net/) | ||
|
||
Use Cabal to install the HSQL backends that you want to use. | ||
|
||
* Extra requirements for Windows | ||
|
||
- Cygwin (found at www.cygwin.com) | ||
Except the default packages you will also need Make and GCC | ||
|
||
- Microsoft Data Access Components (MDAC) SDK (found at | ||
http://www.msdn.com/download) | ||
|
||
- wxHaskell (http://wxhaskell.sourceforge.net/) | ||
|
||
wxHaskell's database support requires wxWidgets built with ODBC | ||
support, which is not enabled by default. | ||
|
||
|
||
Database support: | ||
|
||
- HSQL ODBC | ||
|
||
HaskellDB should work with all ODBC drivers, assuming that the database | ||
supports the queries generated by HaskellDB. This does for exaemple | ||
currently not include the stable version of MySQL, see below. | ||
|
||
- HSQL MySQL | ||
|
||
HaskellDB only works with MySQL version >= 4.1 since earlier | ||
versions don't support nested subqueries. | ||
|
||
It is currently not possible to build HSQL's MySQL support under | ||
Windows. If you figure it out, let us know. | ||
|
||
MySQL only supports transactions on transaction-safe table types, | ||
such as InnoDB and BDB. The default table type, MyISAM, does not | ||
support transactions. See the MySQL manual for more information. | ||
|
||
MySQL 4.1 does not support intersect. | ||
|
||
- HSQL PostgreSQL | ||
|
||
Works. | ||
|
||
- HSQL SQLite | ||
|
||
Works, but since SQLite is untyped, DBDirect reports the types of | ||
all columns in SQLite databases as String, even if some other type | ||
was used when the table was created. To work around this, create the | ||
database description modules using | ||
- GHC 6.2 | ||
|
||
Database.HaskellDB.DBSpec.DBSpecToDBDirect.dbInfoToModuleFiles | ||
- Hugs November 2003 (if you want Hugs support) | ||
|
||
There are some problems with escaping of certain characters | ||
(whitspace and backslash) for SQLite, sicne SQLite does not expect | ||
them to be escaped. | ||
- The CVS version of HSQL. The build system assumes that there is a | ||
sibling directory to the directory that this file is in named | ||
HSQL-cvs. That directory contains a copy of | ||
src/drivers/hsql/Makefile.HSQL named Makefile, the CVS version | ||
of HSQL in a directory named HSQL and a symlink to the HSQL | ||
directory named Database. | ||
|
||
- wxHaskell | ||
This can be set up as follows (starting in the directory that this | ||
file is in. | ||
> mkdir ../HSQL-cvs | ||
> cp src/drivers/hsql/Makefile.HSQL ../HSQL-cvs/Makefile | ||
> make -C ../HSQL-cvs | ||
|
||
Works only with GHC. Does not work with MySQL as far as we know. |