kallithea: docs/installation_win

annotate docs/installation_win_old.rst @ 6338:fa1d80d31b48

error: remove unused Pylons-specific img/style methods The img and style methods in the error controller are standard Pylons boilerplate. They are used from the Pylons default error document template. The purpose of these methods is to serve images and stylesheets from the Pylons module, rather than having to copy these files into a particular application installation. Since Kallithea uses a custom error template with our own styles and images, these methods are not actually used.

author	Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
date	Tue, 13 Sep 2016 17:55:12 +0200
parents	8075ec3d0233
children	2c3d30095d5e

rev	line source
4814 d95ea48af67b docs: rename docs/installation_win.rst to docs/installation_win_old.rst, preparing for new docs Mads Kiilerich <madski@unity3d.com> parents: 4522 diff changeset	1 .. _installation_win_old:
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	2
5954 8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	3 ==========================================================
8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	4 Installation on Windows (XP/Vista/Server 2003/Server 2008)
8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	5 ==========================================================
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	6
5433 fbbe80e3322b docs: consistent spacing around headings Mads Kiilerich <madski@unity3d.com> parents: 5425 diff changeset	7
5413 22a3fa3c4254 docs: cleanup of casing, markup and spacing of headings Mads Kiilerich <madski@unity3d.com> parents: 5125 diff changeset	8 First-time install
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	9 ------------------
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	10
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	11 Target OS: Windows XP SP3 32-bit English (Clean installation)
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	12 + All Windows Updates until 24-may-2012
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	13
2838 ba09e335f266 updated windows installation with note of 32 bit system used in example Marcin Kuzminski <marcin@python-works.com> parents: 2358 diff changeset	14 .. note::
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	15
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	16 This installation is for 32-bit systems, for 64-bit Windows you might need
5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	17 to download proper 64-bit versions of the different packages (Windows Installer, Win32py extensions)
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	18 plus some extra tweaks.
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	19 These extra steps haven been marked as "64-bit".
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	20 Tested on Windows Server 2008 R2 SP1, 9-feb-2013.
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	21 If you run into any 64-bit related problems, please check these pages:
5435 60e04a21bf0f docs: more consistent use of -- Mads Kiilerich <madski@unity3d.com> parents: 5434 diff changeset	22
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	23 - http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	24 - http://bugs.python.org/issue7511
2838 ba09e335f266 updated windows installation with note of 32 bit system used in example Marcin Kuzminski <marcin@python-works.com> parents: 2358 diff changeset	25
5435 60e04a21bf0f docs: more consistent use of -- Mads Kiilerich <madski@unity3d.com> parents: 5434 diff changeset	26 Step 1 -- Install Visual Studio 2008 Express
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	27 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	28
4522 a9a1560dad79 setup: clarify that we only support 2.6 and 2.7 Mads Kiilerich <madski@unity3d.com> parents: 4192 diff changeset	29 Optional: You can also install MinGW, but VS2008 installation is easier.
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	30
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	31 Download "Visual C++ 2008 Express Edition with SP1" from:
4815 64b1a2320bcb docs: update Windows installation documentation for Windows 7/Server 2008 R2 and newer Denis Blanchette <dblanchette@coveo.com> parents: 4814 diff changeset	32 http://download.microsoft.com/download/E/8/E/E8EEB394-7F42-4963-A2D8-29559B738298/VS2008ExpressWithSP1ENUX1504728.iso
64b1a2320bcb docs: update Windows installation documentation for Windows 7/Server 2008 R2 and newer Denis Blanchette <dblanchette@coveo.com> parents: 4814 diff changeset	33 (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)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	34
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	35 You can also download full ISO file for offline installation, just
5435 60e04a21bf0f docs: more consistent use of -- Mads Kiilerich <madski@unity3d.com> parents: 5434 diff changeset	36 choose "All -- Offline Install ISO image file" in the previous page and
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	37 choose "Visual C++ 2008 Express" when installing.
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	38
3244 23c816fd6afb fixes #741 add note that VS2008 is the ONLY supported Visual Studio version Marcin Kuzminski <marcin@python-works.com> parents: 3224 diff changeset	39 .. note::
3267 7b74079beec9 coding style: fix trailing and leading spaces and tabs Mads Kiilerich <madski@unity3d.com> parents: 3244 diff changeset	40
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	41 Using other versions of Visual Studio will lead to random crashes.
2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	42 You must use Visual Studio 2008!"
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	43
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	44 .. note::
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	45
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	46 Silverlight Runtime and SQL Server 2008 Express Edition are not
2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	47 required, you can uncheck them
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	48
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	49 .. note::
3413 d79f3505549e whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 3365 diff changeset	50
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	51 64-bit: You also need to install the Microsoft Windows SDK for .NET 3.5 SP1 (.NET 4.0 won't work).
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	52 Download from: http://www.microsoft.com/en-us/download/details.aspx?id=3138
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	53
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	54 .. note::
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	55
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	56 64-bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work.
5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	57 I am not sure why this is not necessary for 32-bit.
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	58 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
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	59
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	60 Step 2 -- Install Python
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	61 ^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	62
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	63 Install Python 2.x.y (x = 6 or 7) x86 version (32-bit). DO NOT USE A 3.x version.
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	64 Download Python 2.x.y from:
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	65 http://www.python.org/download/
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	66
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	67 Choose "Windows Installer" (32-bit version) not "Windows X86-64
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	68 Installer". While writing this guide, the latest version was v2.7.3.
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	69 Remember the specific major and minor version installed, because it will
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	70 be needed in the next step. In this case, it is "2.7".
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	71
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	72 .. note::
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	73
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	74 64-bit: Just download and install the 64-bit version of python.
5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	75
5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	76 Step 3 -- Install Win32py extensions
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	77 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	78
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	79 Download pywin32 from:
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	80 http://sourceforge.net/projects/pywin32/files/
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	81
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	82 - Click on "pywin32" folder
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	83 - Click on the first folder (in this case, Build 217, maybe newer when you try)
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	84 - Choose the file ending with ".win32-py2.x.exe" -> x being the minor
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	85 version of Python you installed (in this case, 7)
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	86 When writing this guide, the file was:
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	87 http://sourceforge.net/projects/pywin32/files/pywin32/Build%20217/pywin32-217.win32-py2.7.exe/download
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	88
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	89 .. note::
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	90
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	91 64-bit: Download and install the 64-bit version.
3413 d79f3505549e whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 3365 diff changeset	92 At the time of writing you can find this at:
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	93 http://sourceforge.net/projects/pywin32/files/pywin32/Build%20218/pywin32-218.win-amd64-py2.7.exe/download
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	94
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	95 Step 4 -- Python BIN
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	96 ^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	97
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	98 Add Python BIN folder to the path
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	99
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	100 You have to add the Python folder to the path, you can do it manually
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	101 (editing "PATH" environment variable) or using Windows Support Tools
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	102 that came preinstalled in Vista/7 and can be installed in Windows XP.
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	103
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	104 - Using support tools on WINDOWS XP:
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	105 If you use Windows XP you can install them using Windows XP CD and
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	106 navigating to \SUPPORT\TOOLS. There, execute Setup.EXE (not MSI).
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	107 Afterwards, open a CMD and type::
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	108
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	109 SETX PATH "%PATH%;[your-python-path]" -M
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	110
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	111 Close CMD (the path variable will be updated then)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	112
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	113 - Using support tools on WINDOWS Vista/7:
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	114
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	115 Open a CMD and type::
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	116
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	117 SETX PATH "%PATH%;[your-python-path]" /M
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	118
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	119 Please substitute [your-python-path] with your Python installation path.
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	120 Typically: C:\\Python27
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	121
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	122 Step 5 -- Kallithea folder structure
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	123 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	124
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	125 Create a Kallithea folder structure
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	126
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	127 This is only a example to install Kallithea, you can of course change
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	128 it. However, this guide will follow the proposed structure, so please
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	129 later adapt the paths if you change them. My recommendation is to use
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	130 folders with NO SPACES. But you can try if you are brave...
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	131
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	132 Create the following folder structure::
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	133
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	134 C:\Kallithea
e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	135 C:\Kallithea\Bin
e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	136 C:\Kallithea\Env
e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	137 C:\Kallithea\Repos
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	138
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	139 Step 6 -- Install virtualenv
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	140 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	141
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	142 Install Virtual Env for Python
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	143
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	144 Navigate to: http://www.virtualenv.org/en/latest/index.html#installation
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	145 Right click on "virtualenv.py" file and choose "Save link as...".
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	146 Download to C:\\Kallithea (or whatever you want)
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	147 (the file is located at
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	148 https://raw.github.com/pypa/virtualenv/master/virtualenv.py)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	149
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	150 Create a virtual Python environment in C:\\Kallithea\\Env (or similar). To
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	151 do so, open a CMD (Python Path should be included in Step3), navigate
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	152 where you downloaded "virtualenv.py", and write::
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	153
5502 ae9ab4c92d46 setup: explicitly use python2 in examples in the documentation Mads Kiilerich <madski@unity3d.com> parents: 5435 diff changeset	154 python2 virtualenv.py C:\Kallithea\Env
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	155
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	156 (--no-site-packages is now the default behaviour of virtualenv, no need
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	157 to include it)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	158
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	159 Step 7 -- Install Kallithea
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	160 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	161
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	162 Finally, install Kallithea
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	163
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	164 Close previously opened command prompt/s, and open a Visual Studio 2008
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	165 Command Prompt (IMPORTANT!!). To do so, go to Start Menu, and then open
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	166 "Microsoft Visual C++ 2008 Express Edition" -> "Visual Studio Tools" ->
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	167 "Visual Studio 2008 Command Prompt"
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	168
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	169 .. note::
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	170
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	171 64-bit: For 64-bit you need to modify the shortcut that is used to start the
3365 2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	172 Visual Studio 2008 Command Prompt. Use right-mouse click to open properties.
2dfefa385fde sync docs changes from stable Marcin Kuzminski <marcin@python-works.com> parents: 3358 diff changeset	173
3358 321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	174 Change commandline from::
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	175
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	176 %comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" x86
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	177
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	178 to::
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	179
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	180 %comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" amd64
321ca2e69004 installation win document updates Marcin Kuzminski <marcin@python-works.com> parents: 3267 diff changeset	181
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	182 In that CMD (loaded with VS2008 PATHs) type::
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	183
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	184 cd C:\Kallithea\Env\Scripts (or similar)
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	185 activate
5519 8c234ae2c258 docs: add advice of upgrading pip and setuptools in new virtualenvs Mads Kiilerich <madski@unity3d.com> parents: 5502 diff changeset	186 pip install --upgrade pip setuptools
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	187
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	188 The prompt will change into "(Env) C:\\Kallithea\\Env\\Scripts" or similar
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	189 (depending of your folder structure). Then type::
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	190
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	191 pip install kallithea
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	192
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	193 (long step, please wait until fully complete)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	194
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	195 Some warnings will appear, don't worry as they are normal.
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	196
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	197 Step 8 -- Configuring Kallithea
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	198 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	199
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	200 steps taken from http://packages.python.org/Kallithea/setup.html
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	201
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	202 You have to use the same Visual Studio 2008 command prompt as Step7, so
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	203 if you closed it reopen it following the same commands (including the
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	204 "activate" one). When ready, just type::
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	205
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	206 cd C:\Kallithea\Bin
e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	207 paster make-config Kallithea production.ini
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	208
5125 2aeaf6367929 spelling: more consistent casing of 'IP' Mads Kiilerich <madski@unity3d.com> parents: 4815 diff changeset	209 Then, you must edit production.ini to fit your needs (network address and
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	210 port, mail settings, database, whatever). I recommend using NotePad++
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	211 (free) or similar text editor, as it handles well the EndOfLine
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	212 character differences between Unix and Windows
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	213 (http://notepad-plus-plus.org/)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	214
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	215 For the sake of simplicity lets run it with the default settings. After
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	216 your edits (if any), in the previous Command Prompt, type::
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	217
4185 aaa7c3331186 Rename paster command setup-rhodecode to setup-db Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 3700 diff changeset	218 paster setup-db production.ini
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	219
5954 8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	220 .. warning:: This time a new database will be installed. You must
8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	221 follow a different process to later :ref:`upgrade <upgrade>`
8075ec3d0233 docs: restructure Kallithea upgrade instructions Søren Løvborg <sorenl@unity3d.com> parents: 5575 diff changeset	222 to a newer Kallithea version.
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	223
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	224 The script will ask you for confirmation about creating a NEW database,
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	225 answer yes (y)
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	226 The script will ask you for repository path, answer C:\\Kallithea\\Repos
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	227 (or similar)
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	228 The script will ask you for admin username and password, answer "admin"
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	229 + "123456" (or whatever you want)
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	230 The script will ask you for admin mail, answer "admin@xxxx.com" (or
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	231 whatever you want)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	232
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	233 If you make some mistake and the script does not end, don't worry, start
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	234 it again.
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	235
5425 5ae8e644aa88 docs: spelling, grammar, content and typography Søren Løvborg <sorenl@unity3d.com> parents: 5413 diff changeset	236 Step 9 -- Running Kallithea
5575 ed2fb6e84a02 docs: use consistent style for section titles Mads Kiilerich <madski@unity3d.com> parents: 5519 diff changeset	237 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	238
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	239 In the previous command prompt, being in the C:\\Kallithea\\Bin folder,
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	240 just type::
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	241
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	242 paster serve production.ini
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	243
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	244 Open yout web server, and go to http://127.0.0.1:5000
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	245
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	246 It works!! :-)
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	247
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	248 Remark:
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	249 If it does not work first time, just Ctrl-C the CMD process and start it
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	250 again. Don't forget the "http://" in Internet Explorer
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	251
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	252 What this Guide does not cover:
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	253
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	254 - Installing Celery
4192 e73a69cb98dc Rename some strings examples and commands in documentation Bradley M. Kuhn <bkuhn@sfconservancy.org> parents: 4185 diff changeset	255 - Running Kallithea as Windows Service. You can investigate here:
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	256
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	257 - http://pypi.python.org/pypi/wsgisvc
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	258 - http://ryrobes.com/python/running-python-scripts-as-a-windows-service/
8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	259 - http://wiki.pylonshq.com/display/pylonscookbook/How+to+run+Pylons+as+a+Windows+service
2358 69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	260
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	261 - Using Apache. You can investigate here:
69df04ee1e2b added detailed step-by-step installation instruction for windows Marcin Kuzminski <marcin@python-works.com> parents: diff changeset	262
3224 8b8edfc25856 whitespace cleanup Marcin Kuzminski <marcin@python-works.com> parents: 2838 diff changeset	263 - https://groups.google.com/group/rhodecode/msg/c433074e813ffdc4

Mercurial > kallithea

annotate docs/installation_win_old.rst @ 6338:fa1d80d31b48