Differences between revisions 30 and 31
Revision 30 as of 2012-11-06 08:10:35
Size: 4032
Comment:
Revision 31 as of 2013-04-29 08:00:39
Size: 2459
Comment: tidy!
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
There are pre-packaged binaries available from the main [[https://couchdb.apache.org/#download|Apache CouchDB]] site for your convenience. There are pre-packaged binaries available from the main [[https://couchdb.apache.org/#download|Apache CouchDB]] site for your convenience. This will always be the latest feature release of CouchDB.
Line 7: Line 7:
The CouchDB project includes GNU autotools based scripts to build from source, which creates a self-extracting install package for Windows. The official release artefact is the [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/source|signed tar.gz archive]], and additionally, a signed binary is available also on the [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/binary/|Apache Mirrors]] for convenience. The CouchDB project includes GNU autotools based scripts to build from source, which creates a self-extracting install package for Windows. The official release artefact is the [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/source|signed tar.gz archive]], and additionally, a signed binary is available also on the [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/binary/win/|Apache Mirrors]] for convenience.
Line 16: Line 16:
 * Windows 7 and Vista
 * Windows Server 2003 and Windows XP
 * Windows 7 and 8
Line 19: Line 18:
It is likely to work on most Windows versions released this century. It is likely to work on most Windows versions released this century, that are supported by the underlying Erlang/OTP runtime.
Line 27: Line 26:
 * '''couchdb-1.2.0''' - With Erlang/OTP R14B04 or R15B, and JS 1.8.5 [[https://couchdb.apache.org/#download|apache]] site. The latest release of CouchDB is always available from the [[https://couchdb.apache.org/#download|offical CouchDB]] site. There are normally 2 versions of the installer, an R14B04 stable Erlang release, and a newer R15 or R16B based release with a newer Erlang/OTP runtime. There is no functional difference between these versions, however you may wish to integrate CouchDB with other Erlang modules that are not yet compatible with the latest OTP release.

 * '''couchdb-1.3.0''' - With Erlang/OTP R14B04 or R15B, and JS 1.8.5 [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/binary/win/1.3.0/|apache mirrors]] site.

 * '''couchdb-1.2.2''' - With Erlang/OTP R14B04 or R15B, and JS 1.8.5 [[http://www.apache.org/dyn/closer.cgi?path=/couchdb/binary/win/1.2.2/|apache mirrors]].
Line 30: Line 33:
[[http://127.0.0.1:5984/_utils/index.html]] and run the test suite. [[http://127.0.0.1:5984/_utils]] and run "verify install".
Line 32: Line 35:
If you encounter any troubles, in {{{local.ini}}}, set the [log] If you encounter any troubles, edit {{{local.ini}}}, set the [log]
Line 34: Line 37:

== Older Versions ==

 * Previous versions are available at [[http://people.apache.org/~dch/dist/]]

== Antique Versions ==

 * http://people.apache.org/~mhammond/dist/
 * https://github.com/juranki/couchdb/downloads/

== Known Issues pertaining to the Windows build ==

=== CouchDB 1.2.0 ===

 * none known [[http://people.apache.org/~dch/dist/1.2.0/|download]]

=== CouchDB 1.1.1 ===

 * none known [[http://people.apache.org/~dch/dist/1.1.1/|download]]

=== CouchDB 1.0.3 ===

 * [[http://people.apache.org/~dch/dist/1.0.3/|download]]

=== CouchDB 1.0.2 ===

Currently there are a number of non-critical issues in 1.0.2 that you need to be aware of; both have work-arounds documented in the JIRA comments. These are both resolved in CouchDB 1.1.1 and newer.

 * [[https://issues.apache.org/jira/browse/COUCHDB-577|COUCHDB-577]] couchdb @ winxp: Simple RegExp's can not be executed
 * [[https://issues.apache.org/jira/browse/COUCHDB-963|COUCHDB-963]] while running CouchDB as a service, the erlang erlsrv process dies periodically during restarting CouchDB (POST /_restart fails) - either use the .bat version only, or apply the workarounds noted within the ticket comments. This is addressed upstream in Erlang/OTP R14B03 and a work-around in CouchDB 1.0.3 & later.
 * Download '''couchdb-1.0.2''' - With Erlang/OTP R14B01 and JS 1.8.0 [[https://github.com/downloads/dch/couchdb/setup-couchdb-1.0.2+COUCHDB-963_otp_R14B01+OTP-9139.exe|here]]


=== CouchDB 1.0.1 ===

Note that CouchDB versions prior to 1.0.2 should not be used due to:

 * 1 cross-site scripting security issue [[http://couchdb.apache.org/security.html|CVE-2010-3854]]
 * 2 bugs that, in certain situations, could cause data loss [[https://issues.apache.org/jira/browse/COUCHDB-852|COUCHDB-852]] and [[https://issues.apache.org/jira/browse/COUCHDB-844|COUCHDB-844]].
 * Only on Windows, CouchDB 1.0.1 crashes on Windows when a database or index file reaches 4Gb in Erlang/OTP versions previous to R14B01. This is due to a Erlang/OTP Windows bug related with appending to files with a size equal to 4Gb or larger. Erlang/OTP release R14B01 no longer has this bug.
 * A significant stability bug was resolved in Erlang/OTP R13B04 which caused CouchDB to hang occasionally when run as a service.

The official documentation has moved to http://docs.couchdb.org — The transition is not 100% complete, but http://docs.couchdb.org should be seen as having the latest info. In some cases, the wiki still has some more or older info on certain topics inside CouchDB.

You need to be added to the ContributorsGroup to edit the wiki. But don't worry! Just email any Mailing List or grab us on IRC and let us know your user name.

There are pre-packaged binaries available from the main Apache CouchDB site for your convenience. This will always be the latest feature release of CouchDB.

The CouchDB project includes GNU autotools based scripts to build from source, which creates a self-extracting install package for Windows. The official release artefact is the signed tar.gz archive, and additionally, a signed binary is available also on the Apache Mirrors for convenience.

Instructions on building from source are available, as well as annotations for older releases.

Supported / Tested Platforms

This installer has been tested on 64 and 32 bit versions of:

  • Windows Server 2008 both RTM and R2
  • Windows 7 and 8

It is likely to work on most Windows versions released this century, that are supported by the underlying Erlang/OTP runtime.

Dependencies

None - the installer includes erlang, openssl, ICU, spidermonkey and everything else you need including Microsoft Visual C++ runtimes.

Current Versions

The latest release of CouchDB is always available from the offical CouchDB site. There are normally 2 versions of the installer, an R14B04 stable Erlang release, and a newer R15 or R16B based release with a newer Erlang/OTP runtime. There is no functional difference between these versions, however you may wish to integrate CouchDB with other Erlang modules that are not yet compatible with the latest OTP release.

Use Firefox to run the CouchDB tests from Futon, to verify that your installation is successful, by pointing your web browser to http://127.0.0.1:5984/_utils and run "verify install".

If you encounter any troubles, edit local.ini, set the [log] level=debug and begin investigating. Bug reports and patches are welcomed!

Installing_on_Windows (last edited 2013-04-29 08:00:39 by DaveCottlehuber)