diff --git a/AdvancedInstall.md b/AdvancedInstall.md index ec1ce8e..5939779 100644 --- a/AdvancedInstall.md +++ b/AdvancedInstall.md @@ -1,13 +1,11 @@ # Additional !Build/Install Documentation - -Hopefully, the basic install docs in -[docs/install.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/install.html) -are enough for the most common use cases. This page provides additional -information for specific platforms. +The quick start docs in +[docs/quickstart.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.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. 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 -the most general cases will be folded into docs/install.html . +while building Tahoe-LAFS. Information which may be useful in +the most general cases will be folded into docs/quickstart.html . ## 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` -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 @@ -179,25 +177,25 @@ You will need the standard Xcode development tools installed, or at least GCC in === 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`). -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? === @@ -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++. -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] @@ -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). -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 . This is needed for OpenSSL.