[Couchdb Wiki] Update of "Quirks_on_Windows" by DaveCottlehuber

[Apache Wiki <wi...@apache.org>]

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 ||