From e3797c57f976847c39512a1f3492dfd9b0c6e7fc Mon Sep 17 00:00:00 2001 From: davidsarah <> Date: Sat, 29 Jan 2011 21:01:00 +0000 Subject: [PATCH] update Windows section [Imported from Trac: page AdvancedInstall, version 38] --- AdvancedInstall.md | 24 +++++++++++------------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/AdvancedInstall.md b/AdvancedInstall.md index cc27449..f49f89f 100644 --- a/AdvancedInstall.md +++ b/AdvancedInstall.md @@ -2,7 +2,7 @@ 1. Additional Build/Install Documentation
-2 Packaged By The Operating System
+2. Packaged By The Operating System
3. Dependencies
4. Overview
5. The "Desert Island" Build
@@ -277,31 +277,29 @@ Note that Xcode is quite large (2.5GB) so plan accordingly if you will need to d ### Windows -The following procedure will build and run Tahoe-LAFS on Windows. (This is basically exactly the [docs/quickstart.html](http://tahoe-lafs.org/source/tahoe-lafs/trunk/docs/quickstart.html) procedure except with Windows-specific paths spelled out.) +The following procedure will build and run Tahoe-LAFS on Windows. (This is basically source:docs/quickstart.html and part of source:docs/running.html with Windows-specific paths spelled out.) 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: -1. Download and install Python 2.6.5 from . +1. Download and install Python 2.6.6 from (or for 64-bit Windows, ). -2. Download and install pywin32 from . +2. Download the latest Tahoe-LAFS release from . Unpack it in a convenient place, such as C:\tahoe-lafs. -3. Download the latest Tahoe-LAFS release from . Unpack it in a convenient place, such as C:\tahoe-lafs. +3. 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`). +4. 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. -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. +5. Run "`C:\tahoe-lafs\bin\tahoe create-client C:\tahoelafsbase`". Choose an appropriate base directory. -6. Run "`C:\Python26\Scripts\tahoe create-client --basedir C:\tahoelafsbase`". Choose an appropriate base directory. +6. 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 [TestGrid](TestGrid) to get the FURL of the introducer for the testgrid. -7. 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 [TestGrid](TestGrid) to get the FURL of the introducer for the testgrid. - -8. 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. +7. Run "`C:\tahoe-lafs\bin\tahoe start 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. `C:\Python26\python setup.py install` can also optionally be used as on other platforms. [=#point9.4.1] ==== What if that doesn't work? ==== -If the build or install steps result in an error that says a compiler is needed, install the MinGW C/C++ compiler as follows: +The build or install steps could result in an error that says a compiler is needed. If this happens and you are using Python 2.6, it is a packaging bug that should be reported to the tahoe-dev list. If you are using a different version of Python or want to compile the C/C++ components yourself, install the MinGW C/C++ compiler as follows (this only works for 32-bit Windows): 1. Download and install MinGW from http://sourceforge.net/projects/mingw/files/ (the main installer linked from the big green download button). The installer will prompt you for what components to install. You need the base components plus g++. @@ -314,7 +312,7 @@ If the build or install steps result in an error that says a compiler is needed, compiler=mingw32 ``` -4. Add the MinGW binary path to your Path variable. To do that, go to the control panel (classic view), and double-click "System". Click on the "Advanced" tab (for Vista, click the "Advanced system settings" link on the left and accept the elevation prompt), then click the "Environment Variables" button. Scroll down to the "Path" variable in the "System Variables" list, double-click it, append "`;C:\MinGW\bin`" to the path, and "OK" out of all the dialogs. If you installed MinGW in some place other than `C:\MinGW`, adjust the path appropriately. +4. Add the MinGW binary path to your PATH variable. To do that, go to the control panel (classic view), and double-click "System". Click on the "Advanced" tab (for Vista or later, click the "Advanced system settings" link on the left and accept the elevation prompt), then click the "Environment Variables" button. Scroll down to the "Path" variable in the "System Variables" list, double-click it, append "`;C:\MinGW\bin`" to the path, and "OK" out of all the dialogs. If you installed MinGW in some place other than `C:\MinGW`, adjust the path appropriately. 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).