diff --git a/docs/installation_win_old.rst b/docs/installation_win_old.rst --- a/docs/installation_win_old.rst +++ b/docs/installation_win_old.rst @@ -1,29 +1,30 @@ .. _installation_win_old: - +====================================================================== Installation and upgrade on Windows (XP/Vista/Server 2003/Server 2008) ====================================================================== -First time install + +First-time install :::::::::::::::::: -Target OS: Windows XP SP3 32bit English (Clean installation) +Target OS: Windows XP SP3 32-bit English (Clean installation) + All Windows Updates until 24-may-2012 .. note:: - This installation is for 32bit systems, for 64bit windows you might need - to download proper 64bit versions of the different packages(Windows Installer, Win32py extensions) + This installation is for 32-bit systems, for 64-bit Windows you might need + to download proper 64-bit versions of the different packages (Windows Installer, Win32py extensions) plus some extra tweaks. - These extra steps haven been marked as "64bit". + These extra steps haven been marked as "64-bit". Tested on Windows Server 2008 R2 SP1, 9-feb-2013. - If you run into any 64bit related problems, please check these pages: + If you run into any 64-bit related problems, please check these pages: + - http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/ - http://bugs.python.org/issue7511 -Step1 - Install Visual Studio 2008 Express ------------------------------------------- - +Step 1 -- Install Visual Studio 2008 Express +-------------------------------------------- Optional: You can also install MinGW, but VS2008 installation is easier. @@ -32,7 +33,7 @@ http://download.microsoft.com/download/E (if not found or relocated, google for "visual studio 2008 express" for updated link. This link was taken from http://stackoverflow.com/questions/15318560/visual-c-2008-express-download-link-dead) You can also download full ISO file for offline installation, just -choose "All - Offline Install ISO image file" in the previous page and +choose "All -- Offline Install ISO image file" in the previous page and choose "Visual C++ 2008 Express" when installing. .. note:: @@ -47,34 +48,33 @@ choose "Visual C++ 2008 Express" when in .. note:: - 64bit: You also need to install the Microsoft Windows SDK for .NET 3.5 SP1 (.NET 4.0 won't work). + 64-bit: You also need to install the Microsoft Windows SDK for .NET 3.5 SP1 (.NET 4.0 won't work). Download from: http://www.microsoft.com/en-us/download/details.aspx?id=3138 .. note:: - 64bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work. - I am not sure why this is not necessary for 32bit. + 64-bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work. + I am not sure why this is not necessary for 32-bit. Copy C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\bin\vcvars64.bat to C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\bin\amd64\vcvarsamd64.bat +Step 2 -- Install Python +------------------------ -Step2 - Install Python ----------------------- - -Install Python 2.x.y (x = 6 or 7) x86 version (32bit). DO NOT USE A 3.x version. +Install Python 2.x.y (x = 6 or 7) x86 version (32-bit). DO NOT USE A 3.x version. Download Python 2.x.y from: http://www.python.org/download/ -Choose "Windows Installer" (32bit version) not "Windows X86-64 +Choose "Windows Installer" (32-bit version) not "Windows X86-64 Installer". While writing this guide, the latest version was v2.7.3. Remember the specific major and minor version installed, because it will be needed in the next step. In this case, it is "2.7". .. note:: - 64bit: Just download and install the 64bit version of python. + 64-bit: Just download and install the 64-bit version of python. -Step3 - Install Win32py extensions ----------------------------------- +Step 3 -- Install Win32py extensions +------------------------------------ Download pywin32 from: http://sourceforge.net/projects/pywin32/files/ @@ -88,12 +88,12 @@ http://sourceforge.net/projects/pywin32/ .. note:: - 64bit: Download and install the 64bit version. + 64-bit: Download and install the 64-bit version. At the time of writing you can find this at: http://sourceforge.net/projects/pywin32/files/pywin32/Build%20218/pywin32-218.win-amd64-py2.7.exe/download -Step4 - Python BIN ------------------- +Step 4 -- Python BIN +-------------------- Add Python BIN folder to the path @@ -119,9 +119,8 @@ that came preinstalled in Vista/7 and ca Please substitute [your-python-path] with your Python installation path. Typically: C:\\Python27 - -Step5 - Kallithea folder structure ----------------------------------- +Step 5 -- Kallithea folder structure +------------------------------------ Create a Kallithea folder structure @@ -137,9 +136,8 @@ Create the following folder structure:: C:\Kallithea\Env C:\Kallithea\Repos - -Step6 - Install virtualenv ---------------------------- +Step 6 -- Install virtualenv +---------------------------- Install Virtual Env for Python @@ -158,9 +156,8 @@ where you downloaded "virtualenv.py", an (--no-site-packages is now the default behaviour of virtualenv, no need to include it) - -Step7 - Install Kallithea -------------------------- +Step 7 -- Install Kallithea +--------------------------- Finally, install Kallithea @@ -171,7 +168,7 @@ Command Prompt (**IMPORTANT!!**). To do .. note:: - 64bit: For 64bit you need to modify the shortcut that is used to start the + 64-bit: For 64-bit you need to modify the shortcut that is used to start the Visual Studio 2008 Command Prompt. Use right-mouse click to open properties. Change commandline from:: @@ -182,7 +179,6 @@ to:: %comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" amd64 - In that CMD (loaded with VS2008 PATHs) type:: cd C:\Kallithea\Env\Scripts (or similar) @@ -197,10 +193,8 @@ The prompt will change into "(Env) C:\\K Some warnings will appear, don't worry as they are normal. - -Step8 - Configuring Kallithea ------------------------------ - +Step 8 -- Configuring Kallithea +------------------------------- steps taken from http://packages.python.org/Kallithea/setup.html @@ -211,7 +205,7 @@ if you closed it reopen it following the cd C:\Kallithea\Bin paster make-config Kallithea production.ini -Then, you must edit production.ini to fit your needs (ip address, ip +Then, you must edit production.ini to fit your needs (network address and port, mail settings, database, whatever). I recommend using NotePad++ (free) or similar text editor, as it handles well the EndOfLine character differences between Unix and Windows @@ -237,10 +231,8 @@ whatever you want) If you make some mistake and the script does not end, don't worry, start it again. - -Step9 - Running Kallithea -------------------------- - +Step 9 -- Running Kallithea +--------------------------- In the previous command prompt, being in the C:\\Kallithea\\Bin folder, just type:: @@ -255,8 +247,6 @@ Remark: If it does not work first time, just Ctrl-C the CMD process and start it again. Don't forget the "http://" in Internet Explorer - - What this Guide does not cover: - Installing Celery