change Windows docs to recommend Python 2.5 instead of Python 2.6 as MinGW can't build Python 2.6-compatible extensions (sometimes?)
[Imported from Trac: page AdvancedInstall, version 2]
parent
4b9d57c293
commit
8883a41691
|
@ -1,13 +1,11 @@
|
||||||
# Additional !Build/Install Documentation
|
# Additional !Build/Install Documentation
|
||||||
|
The quick start docs in
|
||||||
Hopefully, the basic install docs in
|
[docs/quickstart.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html)
|
||||||
[docs/install.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/install.html)
|
are sufficient to get Tahoe-LAFS running on all platforms. If you have trouble getting it to work by following [docs/quickstart.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html) then please write to [the tahoe-dev mailing list](http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev) and ask for help.
|
||||||
are enough for the most common use cases. This page provides additional
|
|
||||||
information for specific platforms.
|
|
||||||
|
|
||||||
Please feel free to add sections to this page with anything you might learn
|
Please feel free to add sections to this page with anything you might learn
|
||||||
while building Tahoe-LAFS on other platforms. Information which may be useful in
|
while building Tahoe-LAFS. Information which may be useful in
|
||||||
the most general cases will be folded into docs/install.html .
|
the most general cases will be folded into docs/quickstart.html .
|
||||||
|
|
||||||
## Dependencies
|
## Dependencies
|
||||||
|
|
||||||
|
@ -17,7 +15,7 @@ This isn't a complete list of dependencies though, because some of those package
|
||||||
|
|
||||||
`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`
|
`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`
|
||||||
|
|
||||||
In addition to these, if you are installing on Microsoft Windows, then you need to manually install [pywin32](http://sourceforge.net/projects/pywin32) before installing Tahoe-LAFS.
|
In addition to these, if you are running on Microsoft Windows, then you need to manually install [pywin32](http://sourceforge.net/projects/pywin32) before setting up Tahoe-LAFS.
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
|
@ -179,25 +177,25 @@ You will need the standard Xcode development tools installed, or at least GCC in
|
||||||
|
|
||||||
=== Windows ===
|
=== Windows ===
|
||||||
|
|
||||||
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:
|
The 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:
|
||||||
|
|
||||||
1. Download and install Python 2.6.2 from http://www.python.org/ftp/python/2.6.2/python-2.6.2.msi.
|
1. Download and install Python 2.5.4 from http://www.python.org/ftp/python/2.5.4/python-2.5.4.msi.
|
||||||
|
|
||||||
2. Download and install pywin32 from http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.6.exe/download.
|
2. Download and install pywin32 from http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.5.exe/download.
|
||||||
|
|
||||||
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.
|
3. 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.
|
||||||
|
|
||||||
4. Open a command prompt and cd to the top of the Tahoe-LAFS tree (e.g. `cd \tahoe-lafs`).
|
4. Open a command prompt and cd to the top of the Tahoe-LAFS tree (e.g. `cd \tahoe-lafs`).
|
||||||
|
|
||||||
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.
|
5. 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.
|
||||||
|
|
||||||
6. Run "`C:\Python26\python setup.py install`". Wait a bit until it stops working. Again, you may need a working network connection.
|
6. Run "`C:\Python25\python setup.py install`". Wait a bit until it stops working. Again, you may need a working network connection.
|
||||||
|
|
||||||
7. Run "`C:\Python26\Scripts\tahoe create-client --basedir C:\tahoelafsbase`". Choose an appropriate base directory.
|
7. Run "`C:\Python25\Scripts\tahoe create-client --basedir C:\tahoelafsbase`". Choose an appropriate base directory.
|
||||||
|
|
||||||
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 .
|
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. See [wiki:TestGrid TestGrid] to get the FURL of the introducer for the testgrid.
|
||||||
|
|
||||||
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.
|
9. 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.
|
||||||
|
|
||||||
=== What if that doesn't work? ===
|
=== What if that doesn't work? ===
|
||||||
|
|
||||||
|
@ -205,7 +203,7 @@ If the build or install steps result in an error that says a compiler is needed,
|
||||||
|
|
||||||
1. 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++.
|
1. 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++.
|
||||||
|
|
||||||
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:
|
2. 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:
|
||||||
|
|
||||||
```
|
```
|
||||||
[build]
|
[build]
|
||||||
|
@ -216,7 +214,7 @@ compiler=mingw32
|
||||||
|
|
||||||
After 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).
|
After 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).
|
||||||
|
|
||||||
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:
|
To install OpenSSL:
|
||||||
|
|
||||||
1. 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.
|
1. 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.
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue