Changes between Version 1 and Version 2 of AdvancedInstall


Ignore:
Timestamp:
2010-04-21T17:03:06Z (14 years ago)
Author:
zooko
Comment:

change Windows docs to recommend Python 2.5 instead of Python 2.6 as MinGW can't build Python 2.6-compatible extensions (sometimes?)

Legend:

Unmodified
Added
Removed
Modified
  • AdvancedInstall

    v1 v2  
    11= Additional !Build/Install Documentation =
    2 
    3 Hopefully, the basic install docs in
    4 [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/install.html docs/install.html]
    5 are enough for the most common use cases. This page provides additional
    6 information for specific platforms.
     2The quick start docs in
     3[http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html docs/quickstart.html]
     4are sufficient to get Tahoe-LAFS running on all platforms. If you have trouble getting it to work by following [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html docs/quickstart.html] then please write to [http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev the tahoe-dev mailing list] and ask for help.
    75
    86Please feel free to add sections to this page with anything you might learn
    9 while building Tahoe-LAFS on other platforms. Information which may be useful in
    10 the most general cases will be folded into docs/install.html .
     7while building Tahoe-LAFS. Information which may be useful in
     8the most general cases will be folded into docs/quickstart.html .
    119
    1210== Dependencies ==
     
    1816`zope.interface: 3.5.0, simplejson: 2.0.7, pyutil: 1.3.30, zbase32: 1.1.1, allmydata-tahoe: 1.2.0-r3353, pyOpenSSL: 0.7, Twisted: 8.1.0-r25700, Nevow: 0.9.33-r17166, foolscap: 0.3.2, zfec: 1.4.2, pycryptopp: 0.5.12, argparse: 0.8.0, setuptools: 0.6c10dev`
    1917
    20 In addition to these, if you are installing on Microsoft Windows, then you need to manually install [http://sourceforge.net/projects/pywin32 pywin32] before installing Tahoe-LAFS.
     18In addition to these, if you are running on Microsoft Windows, then you need to manually install [http://sourceforge.net/projects/pywin32 pywin32] before setting up Tahoe-LAFS.
    2119
    2220== Overview ==
     
    180178=== Windows ===
    181179
    182 The following procedure will install and run Tahoe-LAFS on Windows.  Note that this assumes that you install Python in the default location (C:\Python26), if you choose another location you'll need to adjust the instructions below:
    183 
    184 1. Download and install Python 2.6.2 from http://www.python.org/ftp/python/2.6.2/python-2.6.2.msi.
    185 
    186 2. Download and install pywin32 from http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.6.exe/download.
    187 
    188 3. Download the latest Tahoe-LAFS snapshot from http://tahoe-lafs.org/source/tahoe-lafs/snapshots/. Unpack it in a convenient place, such as C:\tahoe-lafs.
     180The following procedure will install and run Tahoe-LAFS on Windows. (This is basically exactly the [http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html docs/quickstart.html] procedure except with Windows-specific paths spelled out.) Note that this assumes that you install Python in the default location (C:\Python25), if you choose another location you'll need to adjust the instructions below:
     181
     1821. Download and install Python 2.5.4 from http://www.python.org/ftp/python/2.5.4/python-2.5.4.msi.
     183
     1842. Download and install pywin32 from http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.5.exe/download.
     185
     1863. Download the latest Tahoe-LAFS release from http://tahoe-lafs.org/source/tahoe-lafs/releases/. Unpack it in a convenient place, such as C:\tahoe-lafs.
    189187
    1901884. Open a command prompt and cd to the top of the Tahoe-LAFS tree (e.g. {{{cd \tahoe-lafs}}}).
    191189
    192 5. Run "{{{C:\Python26\python setup.py build}}}". Wait a bit until it stops working. Note that you need a working network connection because it will download various dependencies. Ignore any warnings referring to darcs.
    193 
    194 6. Run "{{{C:\Python26\python setup.py install}}}". Wait a bit until it stops working. Again, you may need a working network connection.
    195 
    196 7. Run "{{{C:\Python26\Scripts\tahoe create-client --basedir C:\tahoelafsbase}}}".  Choose an appropriate base directory.
    197 
    198 8. Run "{{{notepad C:\tahoelafsbase\tahoe.cfg}}}" to edit your config file. After "{{{introducer.furl = }}}", paste in the FURL of the introducer for the grid you want to connect to.  The test grid FURL is pb://todjw7qkb4dgq4fkeo7cqydcu5vneioh@tahoecs2.allmydata.com:52106/introducer .
    199 
    200 9. Run "{{{C:\Python26\Scripts\tahoe start --basedir C:\tahoelafsbase}}}". Your node will start running and connect to the grid. The Windows firewall may ask whether or not to allow python to make network connections. Say yes.
     1905. Run "{{{C:\Python25\python setup.py build}}}". Wait a bit until it stops working. Note that you need a working network connection because it will download various dependencies. Ignore any warnings.
     191
     1926. Run "{{{C:\Python25\python setup.py install}}}". Wait a bit until it stops working. Again, you may need a working network connection.
     193
     1947. Run "{{{C:\Python25\Scripts\tahoe create-client --basedir C:\tahoelafsbase}}}".  Choose an appropriate base directory.
     195
     1968. Run "{{{notepad C:\tahoelafsbase\tahoe.cfg}}}" to edit your config file. After "{{{introducer.furl = }}}", paste in the FURL of the introducer for the grid you want to connect to.  See [wiki:TestGrid TestGrid] to get the FURL of the introducer for the testgrid.
     197
     1989. Run "{{{C:\Python25\Scripts\tahoe start --basedir C:\tahoelafsbase}}}". Your node will start running and connect to the grid. The Windows firewall may ask whether or not to allow python to make network connections. Say yes.
    201199
    202200=== What if that doesn't work? ===
     
    2062041. Download and install MinGW from  http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/MinGW%205.1.4/MinGW-5.1.4.exe/download. The installer will prompt you for what components to install. You need the base components plus g++.
    207205
    208 2. Configure distutils to use MinGW. To configure distutils to use mingw32, create a file called "distutils.cfg" in C:\Python26\lib\distutils, and put in that file:
     2062. Configure distutils to use MinGW. To configure distutils to use mingw32, create a file called "distutils.cfg" in C:\Python25\lib\distutils, and put in that file:
    209207
    210208{{{
     
    217215After installing the compilers, repeat the above instructions from step 4 (using a new command prompt to make sure that the environment variable setting has taken effect).
    218216
    219 If you prefer to use Python 2.5, you must install a 2.5 build of pywin32 and also install OpenSSL or Tahoe-LAFS will fail to run with an error about being unable to find ssl.dll.  To install OpenSSL:
     217To install OpenSSL:
    220218
    2212191. Download and install the Visual Studio 2008 redistributables from  http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en. This is needed for OpenSSL.