couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <>
Subject [Couchdb Wiki] Update of "Quirks_on_Windows" by DaveCottlehuber
Date Thu, 29 Jul 2010 14:18:50 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The "Quirks_on_Windows" page has been changed by DaveCottlehuber.


New page:
= Quirks on Windows =
This page will help you relax on Windows just as much as anywhere else.

== Build ==
 * use only 32-bit components even if you are building on a 64-bit architecture
 * make sure you have a clean path with your build chain first - watch out for other developer
tools like git, which may have older versions of OpenSSL or ICU binaries in your path
 * Firefox is the only supported browser for running the Futon test suite - some tests still
fail due to platform differences however
 * Online compaction is not supported on Windows due to differences between UX and Windows
on renaming/deleting files that are open in another process/thread

== Upgrade ==
 * recommendation is to backup, uninstall, re-install, validate using Futon test suite, restore
data, rather than an in-place upgrade
 * this ensures you have a cruft-free experience while the windows build & installer continues
to change

== Run ==
 * You can still complete compaction of your couch by stopping CouchDB and deleting/renaming
the appropriate data files - just be careful
 * the crash-safe storage engine means you can hibernate or reboot at will without data loss
 * VSS snapshots for backup are a really good way to go
 * Firefox is the only supported browser for the test suite, but for almost anything else
a current version of IE will work "just fine". YMMV
 * you can restart the CouchDB service via commandline, the Services control panel, or build
yourself a shortcut or .cmd file to do the trick also:

net.exe stop "Apache CouchDB" && net.exe start "Apache CouchDB"
 * cURL works just fine on Windows -- once you understand the unwritten rules of quotes which
are very different to that on Unix. The standard example from CouchDB the Definitive Guide
will fail with a "Invalid UTF-8 JSON" error

curl-X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af
-d '{"title":"There is Nothing Left to Lose","artist":"Foo Fighters"}'
 * the 2 alternatives are either to include your JSON-encoded data as a file:

 curl-X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af
-d @foo.json
 * or to use one of the three escape character sequences ("" or a ^" or a \") for every internal
quote, to get past the cmd.exe shell

curl -X PUT http://@ -d "{\"title\":\"There
is Nothing Left to Lose\",\"artist\":\"Foo Fighters\"}"

View raw message