Mercurial > kallithea

comparison docs/installation_win_old.rst @ 7626:19af3fef3b34 stable

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge default to stable for 0.4.0
author Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>
date Sun, 31 Mar 2019 21:28:56 +0200
parents b777b096d9a2 3158cf0dafb7
children a7d7157eca8e
comparison
equal deleted inserted replaced
7558:fdee9a036bee 7626:19af3fef3b34
1 .. _installation_win_old: 1 .. _installation_win_old:
2 2
3 ====================================================================== 3 ==========================================================
4 Installation and upgrade on Windows (XP/Vista/Server 2003/Server 2008) 4 Installation on Windows (XP/Vista/Server 2003/Server 2008)
5 ====================================================================== 5 ==========================================================
6 6
7 7
8 First-time install 8 First-time install
9 :::::::::::::::::: 9 ------------------
10 10
11 Target OS: Windows XP SP3 32-bit English (Clean installation) 11 Target OS: Windows XP SP3 32-bit English (Clean installation)
12 + All Windows Updates until 24-may-2012 12 + All Windows Updates until 24-may-2012
13 13
14 .. note:: 14 .. note::
22 22
23 - http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/ 23 - http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/
24 - http://bugs.python.org/issue7511 24 - http://bugs.python.org/issue7511
25 25
26 Step 1 -- Install Visual Studio 2008 Express 26 Step 1 -- Install Visual Studio 2008 Express
27 -------------------------------------------- 27 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
28 28
29 Optional: You can also install MinGW, but VS2008 installation is easier. 29 Optional: You can also install MinGW, but VS2008 installation is easier.
30 30
31 Download "Visual C++ 2008 Express Edition with SP1" from: 31 Download "Visual C++ 2008 Express Edition with SP1" from:
32 http://download.microsoft.com/download/E/8/E/E8EEB394-7F42-4963-A2D8-29559B738298/VS2008ExpressWithSP1ENUX1504728.iso 32 http://download.microsoft.com/download/E/8/E/E8EEB394-7F42-4963-A2D8-29559B738298/VS2008ExpressWithSP1ENUX1504728.iso
56 64-bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work. 56 64-bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work.
57 I am not sure why this is not necessary for 32-bit. 57 I am not sure why this is not necessary for 32-bit.
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 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
59 59
60 Step 2 -- Install Python 60 Step 2 -- Install Python
61 ------------------------ 61 ^^^^^^^^^^^^^^^^^^^^^^^^
62 62
63 Install Python 2.x.y (x = 6 or 7) x86 version (32-bit). DO NOT USE A 3.x version. 63 Install Python 2.x.y (x = 6 or 7) x86 version (32-bit). DO NOT USE A 3.x version.
64 Download Python 2.x.y from: 64 Download Python 2.x.y from:
65 http://www.python.org/download/ 65 http://www.python.org/download/
66 66
72 .. note:: 72 .. note::
73 73
74 64-bit: Just download and install the 64-bit version of python. 74 64-bit: Just download and install the 64-bit version of python.
75 75
76 Step 3 -- Install Win32py extensions 76 Step 3 -- Install Win32py extensions
77 ------------------------------------ 77 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
78 78
79 Download pywin32 from: 79 Download pywin32 from:
80 http://sourceforge.net/projects/pywin32/files/ 80 http://sourceforge.net/projects/pywin32/files/
81 81
82 - Click on "pywin32" folder 82 - Click on "pywin32" folder
91 64-bit: Download and install the 64-bit version. 91 64-bit: Download and install the 64-bit version.
92 At the time of writing you can find this at: 92 At the time of writing you can find this at:
93 http://sourceforge.net/projects/pywin32/files/pywin32/Build%20218/pywin32-218.win-amd64-py2.7.exe/download 93 http://sourceforge.net/projects/pywin32/files/pywin32/Build%20218/pywin32-218.win-amd64-py2.7.exe/download
94 94
95 Step 4 -- Python BIN 95 Step 4 -- Python BIN
96 -------------------- 96 ^^^^^^^^^^^^^^^^^^^^
97 97
98 Add Python BIN folder to the path 98 Add Python BIN folder to the path
99 99
100 You have to add the Python folder to the path, you can do it manually 100 You have to add the Python folder to the path, you can do it manually
101 (editing "PATH" environment variable) or using Windows Support Tools 101 (editing "PATH" environment variable) or using Windows Support Tools
118 118
119 Please substitute [your-python-path] with your Python installation path. 119 Please substitute [your-python-path] with your Python installation path.
120 Typically: C:\\Python27 120 Typically: C:\\Python27
121 121
122 Step 5 -- Kallithea folder structure 122 Step 5 -- Kallithea folder structure
123 ------------------------------------ 123 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
124 124
125 Create a Kallithea folder structure 125 Create a Kallithea folder structure
126 126
127 This is only a example to install Kallithea, you can of course change 127 This is only a example to install Kallithea, you can of course change
128 it. However, this guide will follow the proposed structure, so please 128 it. However, this guide will follow the proposed structure, so please
135 C:\Kallithea\Bin 135 C:\Kallithea\Bin
136 C:\Kallithea\Env 136 C:\Kallithea\Env
137 C:\Kallithea\Repos 137 C:\Kallithea\Repos
138 138
139 Step 6 -- Install virtualenv 139 Step 6 -- Install virtualenv
140 ---------------------------- 140 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
141 141
142 Install Virtual Env for Python 142 Install Virtual Env for Python
143 143
144 Navigate to: http://www.virtualenv.org/en/latest/index.html#installation 144 Navigate to: http://www.virtualenv.org/en/latest/index.html#installation
145 Right click on "virtualenv.py" file and choose "Save link as...". 145 Right click on "virtualenv.py" file and choose "Save link as...".
155 155
156 (--no-site-packages is now the default behaviour of virtualenv, no need 156 (--no-site-packages is now the default behaviour of virtualenv, no need
157 to include it) 157 to include it)
158 158
159 Step 7 -- Install Kallithea 159 Step 7 -- Install Kallithea
160 --------------------------- 160 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
161 161
162 Finally, install Kallithea 162 Finally, install Kallithea
163 163
164 Close previously opened command prompt/s, and open a Visual Studio 2008 164 Close previously opened command prompt/s, and open a Visual Studio 2008
165 Command Prompt (**IMPORTANT!!**). To do so, go to Start Menu, and then open 165 Command Prompt (**IMPORTANT!!**). To do so, go to Start Menu, and then open
181 181
182 In that CMD (loaded with VS2008 PATHs) type:: 182 In that CMD (loaded with VS2008 PATHs) type::
183 183
184 cd C:\Kallithea\Env\Scripts (or similar) 184 cd C:\Kallithea\Env\Scripts (or similar)
185 activate 185 activate
186 pip install --upgrade pip "setuptools<34" 186 pip install --upgrade pip setuptools
187 187
188 The prompt will change into "(Env) C:\\Kallithea\\Env\\Scripts" or similar 188 The prompt will change into "(Env) C:\\Kallithea\\Env\\Scripts" or similar
189 (depending of your folder structure). Then type:: 189 (depending of your folder structure). Then type::
190 190
191 pip install kallithea 191 pip install kallithea
193 (long step, please wait until fully complete) 193 (long step, please wait until fully complete)
194 194
195 Some warnings will appear, don't worry as they are normal. 195 Some warnings will appear, don't worry as they are normal.
196 196
197 Step 8 -- Configuring Kallithea 197 Step 8 -- Configuring Kallithea
198 ------------------------------- 198 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
199 199
200 steps taken from http://packages.python.org/Kallithea/setup.html 200 steps taken from http://packages.python.org/Kallithea/setup.html
201 201
202 You have to use the same Visual Studio 2008 command prompt as Step7, so 202 You have to use the same Visual Studio 2008 command prompt as Step7, so
203 if you closed it reopen it following the same commands (including the 203 if you closed it reopen it following the same commands (including the
204 "activate" one). When ready, just type:: 204 "activate" one). When ready, just type::
205 205
206 cd C:\Kallithea\Bin 206 cd C:\Kallithea\Bin
207 paster make-config Kallithea production.ini 207 kallithea-cli config-create my.ini
208 208
209 Then, you must edit production.ini to fit your needs (network address and 209 Then, you must edit my.ini to fit your needs (network address and
210 port, mail settings, database, whatever). I recommend using NotePad++ 210 port, mail settings, database, whatever). I recommend using NotePad++
211 (free) or similar text editor, as it handles well the EndOfLine 211 (free) or similar text editor, as it handles well the EndOfLine
212 character differences between Unix and Windows 212 character differences between Unix and Windows
213 (http://notepad-plus-plus.org/) 213 (http://notepad-plus-plus.org/)
214 214
215 For the sake of simplicity lets run it with the default settings. After 215 For the sake of simplicity lets run it with the default settings. After
216 your edits (if any), in the previous Command Prompt, type:: 216 your edits (if any), in the previous Command Prompt, type::
217 217
218 paster setup-db production.ini 218 kallithea-cli db-create -c my.ini
219 219
220 (this time a NEW database will be installed, you must follow a different 220 .. warning:: This time a *new* database will be installed. You must
221 step to later UPGRADE to a newer Kallithea version) 221 follow a different process to later :ref:`upgrade <upgrade>`
222 to a newer Kallithea version.
222 223
223 The script will ask you for confirmation about creating a NEW database, 224 The script will ask you for confirmation about creating a NEW database,
224 answer yes (y) 225 answer yes (y)
225 The script will ask you for repository path, answer C:\\Kallithea\\Repos 226 The script will ask you for repository path, answer C:\\Kallithea\\Repos
226 (or similar) 227 (or similar)
231 232
232 If you make some mistake and the script does not end, don't worry, start 233 If you make some mistake and the script does not end, don't worry, start
233 it again. 234 it again.
234 235
235 Step 9 -- Running Kallithea 236 Step 9 -- Running Kallithea
236 --------------------------- 237 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
237 238
238 In the previous command prompt, being in the C:\\Kallithea\\Bin folder, 239 In the previous command prompt, being in the C:\\Kallithea\\Bin folder,
239 just type:: 240 just type::
240 241
241 paster serve production.ini 242 gearbox serve -c my.ini
242 243
243 Open yout web server, and go to http://127.0.0.1:5000 244 Open yout web server, and go to http://127.0.0.1:5000
244 245
245 It works!! :-) 246 It works!! :-)
246 247
258 - http://wiki.pylonshq.com/display/pylonscookbook/How+to+run+Pylons+as+a+Windows+service 259 - http://wiki.pylonshq.com/display/pylonscookbook/How+to+run+Pylons+as+a+Windows+service
259 260
260 - Using Apache. You can investigate here: 261 - Using Apache. You can investigate here:
261 262
262 - https://groups.google.com/group/rhodecode/msg/c433074e813ffdc4 263 - https://groups.google.com/group/rhodecode/msg/c433074e813ffdc4
263
264
265 Upgrading
266 :::::::::
267
268 Stop running Kallithea
269 Open a CommandPrompt like in Step7 (VS2008 path + activate) and type::
270
271 easy_install -U kallithea
272 cd \Kallithea\Bin
273
274 { backup your production.ini file now} ::
275
276 paster make-config Kallithea production.ini
277
278 (check changes and update your production.ini accordingly) ::
279
280 paster upgrade-db production.ini (update database)
281
282 Full steps in http://packages.python.org/Kallithea/upgrade.html