Mailing-List: contact commits-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Apache Wiki <wikidiffs@apache.org>
To: Apache Wiki <wikidiffs@apache.org>
Date: Tue, 03 Aug 2010 13:34:19 -0000
Message-ID: <20100803133419.87931.64791@eosnew.apache.org>
Subject: 
 =?utf-8?q?=5BCouchdb_Wiki=5D_Trivial_Update_of_=22Quirks=5Fon=5FWindows?=
 =?utf-8?q?=22_by_DaveCottlehuber?=

Dear Wiki user,

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

The "Quirks_on_Windows" page has been changed by DaveCottlehuber.
The comment on this change is: regress python version so that py2exe can be=
 used. provide a quick start guide using hosted couch rather than install &=
 run your own..
http://wiki.apache.org/couchdb/Quirks_on_Windows?action=3Ddiff&rev1=3D4&rev=
2=3D5

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

  =

  =3D=3D Quick Start =3D=3D
  So you just can't wait to relax can you? The fastest route is to:
- * install the tools below excluding CouchDB
- * sign yourself up for the current free no-guarantees [[http://www.couch.=
io/get|beta cloud hosting]]
- * wade into [[http://books.couchdb.org/relax/|the Definitive Guide]] and =
check the quick start notes on using CouchApp
  =

- =3D=3D Tools =3D=3D
+  * unzip [[http://curl.haxx.se/download/curl-7.19.5-win32-ssl-sspi.zip|cu=
rl]] and add to your path
+  * run the latest [[http://github.com/couchapp/couchapp/downloads|couchap=
p 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
+  * read the [[http://github.com/couchapp/couchapp/blob/master/README.md|q=
uick start notes]] on using [[http://www.couchapp.org/|CouchApp]]
+  * wade into [[http://books.couchdb.org/relax/|the Definitive Guide]]
  =

- * For general usage of CouchDB and the essential CouchApp tool, get the f=
ollowing 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 momen=
t.
- =

- =

- ||Tool || WWW || Tested Version ||
- || cURL || http://curl.haxx.se/dlwiz/?type=3Dbin&os=3DWin32 || http://cur=
l.haxx.se/download/curl-7.19.5-win32-ssl-sspi.zip ||
- || Python 2.7.* || http://python.org/ || http://python.org/ftp/python/2.7=
/python-2.7.msi ||
- || !PyWin32 || http://sourceforge.net/projects/pywin32/ || http://sourcef=
orge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.zip/downloa=
d ||
- || !Py2Exe || http://www.py2exe.org/ || http://sourceforge.net/projects/p=
y2exe/files/py2exe/0.6.9/py2exe-0.6.9.zip/download ||
- || OpenSSL || http://www.slproweb.com/products/Win32OpenSSL.html || http:=
//www.slproweb.com/download/Win32OpenSSL-1_0_0a.exe ||
- || CouchDB v0.11.0 || http://people.apache.org/~mhammond/dist/ || http://=
people.apache.org/~mhammond/dist/0.11.0/setup-couchdb-0.11.0.exe ||
- || CouchDB v1.0.0 || http://couch.io/downloads || http://dl.couchone.com/=
dl/2550c382c3e01df830a3525ed6000b7d/couchdb_1.00%2BerlangR14A.zip ||
- =

- =3D=3D Building from Source  =3D=3D
- Note the full build chain is documented in http://github.com/apache/couch=
db/blob/trunk/INSTALL.Windows -- but again you don't need this for *install=
ing* and *using* CouchDB on Windows.
-  * use only 32-bit components even if you are building on a 64-bit archit=
ecture
-  * make sure you have a clean path with your build chain first - watch ou=
t for other developer tools like git, which may have older versions of Open=
SSL 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
- =

- =3D=3D Upgrade =3D=3D
-  * recommendation is to backup, uninstall, re-install, validate using Fut=
on 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
  =

  =3D=3D Run =3D=3D
   * You can still complete compaction of your couch by stopping CouchDB an=
d deleting/renaming the appropriate data files - just be careful
@@ -61, +39 @@

  curl -X PUT http://username:password@localhost:5984/albums/6e1295ed6c2949=
5e54cc05947f18c8af -d "{\"title\":\"There is Nothing Left to Lose\",\"artis=
t\":\"Foo Fighters\"}"
  }}}
  =

+ =3D=3D Tools =3D=3D
+  * For general usage of CouchDB and the essential [[http://www.couchapp.o=
rg|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 mome=
nt.
+  * you'll only need one of the CouchDB versions below -
+ =

+ =

+ ||Tool || WWW || Tested Version ||
+ || cURL || http://curl.haxx.se/dlwiz/?type=3Dbin&os=3DWin32 || http://cur=
l.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 ||
+ || !PyWin32 || http://sourceforge.net/projects/pywin32/ || http://sourcef=
orge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.zip/downloa=
d ||
+ || !Py2Exe || http://www.py2exe.org/ || http://sourceforge.net/projects/p=
y2exe/files/py2exe/0.6.9/py2exe-0.6.9.zip/download ||
+ || OpenSSL || http://www.slproweb.com/products/Win32OpenSSL.html || http:=
//www.slproweb.com/download/Win32OpenSSL-1_0_0a.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.0 on Erlang 14A || http://couch.io/downloads || http://dl=
.couchone.com/dl/2550c382c3e01df830a3525ed6000b7d/couchdb_1.00%2BerlangR14A=
.zip ||
+ =

+ =3D=3D Building from Source  =3D=3D
+ Note the full build chain is documented in http://github.com/apache/couch=
db/blob/trunk/INSTALL.Windows -- but again you don't need this for *install=
ing* and *using* CouchDB on Windows.
+  * use only 32-bit components even if you are building on a 64-bit archit=
ecture
+  * make sure you have a clean path with your build chain first - watch ou=
t for other developer tools like git, which may have older versions of Open=
SSL 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
+ =

+ =3D=3D Upgrade =3D=3D
+  * recommendation is to backup, uninstall, re-install, validate using Fut=
on 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
  =

  =3D=3D Tricks and Traps =3D=3D
   * Online compaction is not supported on Windows due to differences betwe=
en UX and Windows on renaming/deleting files that are open in another proce=
ss/thread