You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@couchdb.apache.org by Apache Wiki <wi...@apache.org> on 2010/09/12 01:36:20 UTC

[Couchdb Wiki] Update of "Quirks_on_Windows" by DaveCottlehuber

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.
The comment on this change is: update to couch 1.0.1 and couchone.
http://wiki.apache.org/couchdb/Quirks_on_Windows?action=diff&rev1=7&rev2=8

--------------------------------------------------

  = Quirks on Windows =
- Using CouchDB does not require installing cygwin, or becoming a command-line guru. If you get stuck here your best bet is [[irc://irc.freenode.net/couchdb|IRC on #couchdb]] or the mailing list. This page will help you relax on Windows just as much as anywhere else!
+ Using CouchDB does not require installing cygwin, or becoming a command-line guru. If you get stuck here your best bet is [[irc://irc.freenode.net/couchdb|IRC on #couchdb]] or the mailing lists. This page will help you relax on Windows just as much as anywhere else!
  
  == Quick Start ==
  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_0a.exe|win32 OpenSSL]] binaries to your system path
-  * run the latest [[http://github.com/couchapp/couchapp/downloads|couchapp installer]]
+  * run the latest [[http://couchapp.org/page/windows-python-installers|couchapp installer]]
-  * sign yourself up for the current free no-guarantees [[http://www.couch.io/get|beta cloud hosting]] to get your own couch ready to go
+  * sign yourself up for the current free no-guarantees [[http://www.couchone.com/get|beta cloud hosting]] to get your own couch ready to go
   * read the [[http://github.com/couchapp/couchapp/blob/master/README.md|quick start notes]] on using [[http://www.couchapp.org/|CouchApp]]
   * wade into [[http://books.couchdb.org/relax/|the Definitive Guide]]
  
  
  == 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
@@ -44, +43 @@

   * For general usage of CouchDB and the essential [[http://www.couchapp.org|CouchApp]] tool, get the following bits installed & added to your path
   * in each case we list the tool, site, then the version last tested with in case you get stuck with version creep
   * the 32-bit tools are recommended even on 64-bit platforms for the moment.
-  * you'll only need one of the CouchDB versions below -
- 
  
  ||Tool || WWW || Tested Version ||
  || cURL || http://curl.haxx.se/dlwiz/?type=bin&os=Win32 || http://curl.haxx.se/download/curl-7.19.5-win32-ssl-sspi.zip ||
- || Python 2.6.5 || http://python.org/ || http://python.org/ftp/python/2.6.5/python-2.6.5.msi ||
+ || Python 2.7 || http://python.org/ || http://python.org/ftp/python/2.7/python-2.7.msi ||
- || !PyWin32 || http://sourceforge.net/projects/pywin32/ || http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.zip/download ||
+ || !PyWin32 || http://sourceforge.net/projects/pywin32/ || http://downloads.sourceforge.net/project/pywin32/pywin32/Build%20214/pywin32-214.win32-py2.7.exe ||
- || !Py2Exe || http://www.py2exe.org/ || http://sourceforge.net/projects/py2exe/files/py2exe/0.6.9/py2exe-0.6.9.zip/download ||
+ || !SetupTools || http://pypi.python.org/ || http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe ||
+ || !RestKit || http://pypi.python.org/ || http://pypi.python.org/packages/2.7/r/restkit/restkit-2.1.4.win32-py2.7.exe ||
  || OpenSSL || http://www.slproweb.com/products/Win32OpenSSL.html || http://www.slproweb.com/download/Win32OpenSSL-1_0_0a.exe ||
+ || CouchApp || http://pypi.python.org/ || http://pypi.python.org/packages/2.7/C/Couchapp/Couchapp-0.7.0.win32-py2.7.exe ||
- || CouchDB v0.11.0 on Erlang 13B04 || http://people.apache.org/~mhammond/dist/ || http://people.apache.org/~mhammond/dist/0.11.0/setup-couchdb-0.11.0.exe ||
+ || CouchDB v1.0.1 on Erlang 14A || http://people.apache.org/~mhammond/dist/ || http://people.apache.org/~mhammond/dist/1.0.1/setup-couchdb-1.0.1.exe ||
- || CouchDB v1.0.0 on Erlang 14A || http://couch.io/downloads || http://dl.couchone.com/dl/2550c382c3e01df830a3525ed6000b7d/couchdb_1.00%2BerlangR14A.zip ||
+ || CouchDB v1.0.0 on Erlang 14A || http://couchone.com/downloads || http://dl.couchone.com/dl/2550c382c3e01df830a3525ed6000b7d/couchdb_1.00%2BerlangR14A.zip ||
  
  == Building from Source  ==
- Note the full build chain is documented in http://github.com/apache/couchdb/blob/trunk/INSTALL.Windows -- but again you don't need this for *installing* and *using* CouchDB on Windows.
+ Note the full build chain is documented in http://github.com/apache/couchdb/blob/trunk/INSTALL.Windows -- but again you don't need this for *installing* and *using* CouchDB on Windows. There are a number of blog posts on this at http://dch.posterous.com/tag/couchdb
   * 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
  
  == 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
+  * this ensures you have a cruft-free experience while both CouchDB, the windows build & its installer continues to change rapidly
  
  == Tricks and Traps ==
-  * 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
+  * 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. This has been worked around in 1.0.1 and requires Erlang/OTP 14A. Recent installers have this built in.
   * if your installed CouchApp.exe doesn't start correctly, you may want to remove two DLLs from it's folder - KernelBase.DLL and PowrProf.DLL which were present in CouchApp.0.6.exe and should be removed.
   * Not much else really since 0.10 if you have any problems feel free to post to the list for advice.