Differences between revisions 12 and 13
Revision 12 as of 2008-08-19 16:06:20
Size: 4879
Editor: bi-02pt1
Comment:
Revision 13 as of 2008-08-19 16:07:41
Size: 4885
Editor: bi-02pt1
Comment:
Deletions are marked like this. Additions are marked like this.
Line 26: Line 26:
CouchDB uses a custom JavaScript driver, which provides unicode and buffering improvements. In the !SpiderMonkey distribution, rename src/js.c to src/js.c.bak, and copy {{C:\Program Files\erl5.6.3\lib\couchdb-0.8.1\src\couchdb\couch_js.c}} from the CouchDB distribution to src/js.c in the !SpiderMonkey distribution. Before running nmake, edit the new js.c and change {{#include <jsapi.h>}} to {{#include "jsapi.h"}}. CouchDB uses a custom JavaScript driver, which provides unicode and buffering improvements. In the !SpiderMonkey distribution, rename src/js.c to src/js.c.bak, and copy {{{C:\Program Files\erl5.6.3\lib\couchdb-0.8.1\src\couchdb\couch_js.c}}} from the CouchDB distribution to src/js.c in the !SpiderMonkey distribution. Before running nmake, edit the new js.c and change {{{#include <jsapi.h>}}} to {{{#include "jsapi.h"}}}.

CouchDB does not natively install on Windows but it is possible to install it by hand.

Please update this guide as needed, we aim to collect feedback and roll the procedure into the official build.

These instructions currently refer to paths as they'd be set up in a default installation of Erlang OTP 5.6.3, with the couchDB distribution installed at

C:\Program Files\erl5.6.3\lib\couchdb-0.8.1

Dependencies

You will need the following software installed on your system:

Building SpiderMonkey

The SpiderMonkey distribution's Windows build stuff is broken. See [http://blog.endflow.net/?p=55&lang=en this blog post] for a working js.mak file. Don't bother trying to import the project file into a contemporary Visual Studio; just use the Visual Studio command line tools with the js.mak file referred to above.

CouchDB uses a custom JavaScript driver, which provides unicode and buffering improvements. In the SpiderMonkey distribution, rename src/js.c to src/js.c.bak, and copy C:\Program Files\erl5.6.3\lib\couchdb-0.8.1\src\couchdb\couch_js.c from the CouchDB distribution to src/js.c in the SpiderMonkey distribution. Before running nmake, edit the new js.c and change #include <jsapi.h> to #include "jsapi.h".

Once you've built js.exe and js32.dll, copy them both to

C:\Program Files\erl5.6.3\erts-5.6.3\bin

Base Installation

After installing Erlang you should having something similar to:

C:\Program Files\erl5.6.3

Copy the whole CouchDB source tree to:

C:\Program Files\erl5.6.3\lib\couchdb-0.8.0

Make the following empty directory:

C:\Program Files\erl5.6.3\lib\mochiweb-0.01\ebin

From ICU copy icu*.dll and libeay32.dll to:

C:\Program Files\erl5.6.3\erts-5.6.2\bin

From SpiderMonkey copy js32.dll and jsshell.exe to:

C:\Program Files\erl5.6.3\erts-5.6.2\bin

C Compilation

couchdb/couch_erl_driver.c

This is a wrapper to provide ICU features to CouchDB.

The simplest way to build a DLL is to create a Win32 DLL project in an IDE, add couch_erl_driver.c into the project, and change project settings to include the Erlang ERTS and ICU4C header paths.

Make the following empty directory:

C:\Program Files\erl5.6.3\lib\couchdb-0.8.0\priv

Copy the DLL to:

C:\Program Files\erl5.6.3\lib\couchdb-0.8.0\priv\couch_erl_driver.dll

couchdb/couch_js.c

This is a wrapper to provide UTF-8 and buffering improvements to SpiderMonkey.

Replace js.c with couch_js.c, and change '#include <jsapi.h>' to '#include "jsapi.h"', then build js.exe again, rename it to couch_js.exe and copy it to:

C:\Program Files\erl5.6.3\erts-5.6.2\bin

Erlang Compilation

Create a the following file:

C:\Program Files\erl5.6.3\lib\couchdb-0.8.0\src\Emakefile

Add the following content:

{'./couchdb/*', [{outdir,"../ebin"}]}.
{'./mochiweb/*', [{outdir,"../../mochiweb-0.01/ebin"}]}.

Launch erl (or werl) and execute the following command to change working directory:

cd("C:/Program Files/erl5.6.3/lib/couchdb-0.8.0/src").

Execute this command to compile CouchDB:

make:all().

Configuring

Copy the following file:

C:\Program Files\erl5.6.3\lib\couchdb-0.8.0\etc\couchdb\couch.ini.tpl.in

To this location:

C:/Program Files/erl5.6.3/bin/couch.ini

Edit the file to look something like this:

[Couch]

ConsoleStartupMsg=Apache CouchDB is starting.

DbRootDir=C:/Path/To/Database/Directory

Port=5984

BindAddress=127.0.0.1

DocumentRoot=C:/Program Files/erl5.6.3/lib/couchdb-0.8.1/share/www

LogFile=C:/Path/To/Log/Directory

UtilDriverDir=C:/Program Files/erl5.6.3/lib/couchdb-0.8.1/priv/

LogLevel=info

[Couch Query Servers]

javascript=couch_js "C:/Program Files/erl5.6.3/lib/couchdb-0.8.1/share/server/main.js"

Make sure that the DbRootDir exists and that the LogFile can be created.

Running

Launch erl (or werl) and execute the following command:

couch_server:start().

To check that everything has worked point your web browser to [http://localhost:5984/_utils/index.html] and run the test suite.