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: http://wiki.apache.org/couchdb/Quirks_on_Windows?action=diff&rev1=15&rev2=16 So you just can't wait to relax can you? The fastest route is to: * unzip [[http://curl.haxx.se/download/curl-7.19.5-win32-ssl-sspi.zip|curl]] and add to your path - * install the corresponding [[http://www.slproweb.com/download/Win32OpenSSL-1_0_0d.exe|win32 OpenSSL]] binaries to your system path + * install the corresponding [[http://www.slproweb.com/products/Win32OpenSSL.html|win32 OpenSSL]] binaries to your system path - * run the latest [[https://github.com/downloads/couchapp/couchapp/couchapp-1.0.0-win.zip|couchapp installer]] + * run the latest [[https://github.com/couchapp/couchapp/downloads|couchapp installer]] - * sign yourself up for free [[http://www.iriscouch.com/service|iriscouch hosting]] or [[https://cloudant.com/#!/solutions/cloud|Cloudant hosting]] to get your own cloud-based couch ready to go + * sign yourself up for free [[http://www.iriscouch.com/service|iriscouch hosting]] or [[https://cloudant.com/#!/solutions/cloud|Cloudant hosting]] to get your own cloud-based couch ready to go - no need to install your own! * read the [[http://github.com/couchapp/couchapp/blob/master/README.md|quick start notes]] on using [[http://www.couchapp.org/|CouchApp]] - * wade into [[http://guide.couchdb.org/draft|the Definitive Guide]] + * wade into [[http://guide.couchdb.org/draft/|the Definitive Guide]] - If you wish, you can install CouchDB yourself instead of using a hosted option, using either [[https://github.com/dch/couchdb/downloads|community binaries]] or the commercially supported [[http://www.couchbase.org/get/couchbase-single/current|CouchBase edition]]. + If you wish, you can install CouchDB yourself instead of using a hosted option, using either [[https://github.com/dch/couchdb/downloads|community binaries]] or the commercially supported [[http://www.couchbase.org/get/couchbase-single/current|CouchBase edition]]. Note that couchbase has [[http://blog.couchbase.com/couchbase-2011-year-review|discontinued support in 2012]]. == Run == * you will likely wish to modify {{{%COUCHDB%\etc\couchdb\local.ini}}} with more appropriate details for IP address & server port (in the [httpd] section), or adjust the log file levels (in [log]) @@ -30, +30 @@ {{{ 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 works just fine on Windows -- once you understand the [[http://technet.microsoft.com/en-us/library/cc723564.aspx|unwritten rules of quoting]] 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 -H "Content-Type: application/json" -X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af -d '{"title":"There is Nothing Left to Lose","artist":"Foo Fighters"}' @@ -40, +40 @@ {{{ curl -H "Content-Type: application/json" -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 + * or to use one of the three [[http://technet.microsoft.com/en-us/library/cc723564.aspx|escape character sequences]] ("" or a ^" or a \") for every internal quote, to get past the cmd.exe shell {{{ curl -H "Content-Type: application/json" -X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af -d "{\"title\":\"There is Nothing Left to Lose\",\"artist\":\"Foo Fighters\"}" }}} == Building from Source == - Note the full build chain is [[http://github.com/apache/couchdb/blob/trunk/INSTALL.Windows|documented]] -- but again you don't need this for *installing* and *using* CouchDB on Windows. There are a number of [[https://github.com/dch/glazier/|scripts]] helping you build from source if needed. + Note the full build chain is [[https://github.com/apache/couchdb/blob/master/INSTALL.Windows|documented]] -- but again you don't need this for *installing* and *using* CouchDB on Windows. There are a number of community-provided [[https://github.com/dch/glazier/|scripts]] helping you build from source if needed. * 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 @@ -100, +100 @@ || use case || erlsrv parameters || impact || || deployed CouchDB service up to 1.0.2 inclusive || {{{erlsrv.exe add "Apache CouchDB" -w "%COUCH%\bin" -ar "-sasl errlog_type error -s couch" -c "Apache CouchDB 1.1.1"}}} || service will not restart automatically; VM not tuned || || Start CouchDB in debug mode || {{{erlsrv.exe add "CouchDeBug" -workdir "%COUCH%\bin" -onfail restart_always -debugtype console -args "-sasl errlog_type error -s couch +A 4 +W w" -comment "CouchDeBug"}}}|| service will restart automatically. Console is accessible to users logged into winsta0 i.e. local interactive users for input || - || Production mode ||{{{erlsrv.exe add "CouchDB_Production" -workdir "%COUCH%\bin" -onfail restart_always -args "-sasl errlog_type error -s couch +A 4 +W w" -comment "CouchDB_Production 1.1.1"}}} || Console hidden, service restarts automatically || + || Production mode and CouchDB versions > 1.0.2 ||{{{erlsrv.exe add "CouchDB_Production" -workdir "%COUCH%\bin" -onfail restart_always -args "-sasl errlog_type error -s couch +A 4 +W w" -comment "CouchDB_Production 1.1.1"}}} || Console hidden, service restarts automatically ||
