Mercurial > kallithea

annotate docs/installation_win_old.rst @ 5978:97bbc2824b32

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
tests: add basic test for mark_all_read action of notifications Adds test coverage for c7dc1c7ace67.
author Konstantin Veretennicov <kveretennicov@gmail.com>
date Wed, 15 Jun 2016 23:38:57 +0200
parents 8075ec3d0233
children 2c3d30095d5e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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