Mercurial > kallithea
annotate docs/installation_win_old.rst @ 6532:33b71a130b16
templates: properly escape inline JavaScript values
TLDR: Kallithea has issues with escaping values for use in inline JS.
Despite judicious poking of the code, no actual security vulnerabilities
have been found, just lots of corner-case bugs. This patch fixes those,
and hardens the code against actual security issues.
The long version:
To embed a Python value (typically a 'unicode' plain-text value) in a
larger file, it must be escaped in a context specific manner. Example:
>>> s = u'<script>alert("It\'s a trap!");</script>'
1) Escaped for insertion into HTML element context
>>> print cgi.escape(s)
<script>alert("It's a trap!");</script>
2) Escaped for insertion into HTML element or attribute context
>>> print h.escape(s)
<script>alert("It's a trap!");</script>
This is the default Mako escaping, as usually used by Kallithea.
3) Encoded as JSON
>>> print json.dumps(s)
"<script>alert(\"It's a trap!\");</script>"
4) Escaped for insertion into a JavaScript file
>>> print '(' + json.dumps(s) + ')'
("<script>alert(\"It's a trap!\");</script>")
The parentheses are not actually required for strings, but may be needed
to avoid syntax errors if the value is a number or dict (object).
5) Escaped for insertion into a HTML inline <script> element
>>> print h.js(s)
("\x3cscript\x3ealert(\"It's a trap!\");\x3c/script\x3e")
Here, we need to combine JS and HTML escaping, further complicated by
the fact that "<script>" tag contents can either be parsed in XHTML mode
(in which case '<', '>' and '&' must additionally be XML escaped) or
HTML mode (in which case '</script>' must be escaped, but not using HTML
escaping, which is not available in HTML "<script>" tags). Therefore,
the XML special characters (which can only occur in string literals) are
escaped using JavaScript string literal escape sequences.
(This, incidentally, is why modern web security best practices ban all
use of inline JavaScript...)
Unsurprisingly, Kallithea does not do (5) correctly. In most cases,
Kallithea might slap a pair of single quotes around the HTML escaped
Python value. A typical benign example:
$('#child_link').html('${_('No revisions')}');
This works in English, but if a localized version of the string contains
an apostrophe, the result will be broken JavaScript. In the more severe
cases, where the text is user controllable, it leaves the door open to
injections. In this example, the script inserts the string as HTML, so
Mako's implicit HTML escaping makes sense; but in many other cases, HTML
escaping is actually an error, because the value is not used by the
script in an HTML context.
The good news is that the HTML escaping thwarts attempts at XSS, since
it's impossible to inject syntactically valid JavaScript of any useful
complexity. It does allow JavaScript errors and gibberish to appear on
the page, though.
In these cases, the escaping has been fixed to use either the new 'h.js'
helper, which does JavaScript escaping (but not HTML escaping), OR the
new 'h.jshtml' helper (which does both), in those cases where it was
unclear if the value might be used (by the script) in an HTML context.
Some of these can probably be "relaxed" from h.jshtml to h.js later, but
for now, using h.jshtml fixes escaping and doesn't introduce new errors.
In a few places, Kallithea JSON encodes values in the controller, then
inserts the JSON (without any further escaping) into <script> tags. This
is also wrong, and carries actual risk of XSS vulnerabilities. However,
in all cases, security vulnerabilities were narrowly avoided due to other
filtering in Kallithea. (E.g. many special characters are banned from
appearing in usernames.) In these cases, the escaping has been fixed
and moved to the template, making it immediately visible that proper
escaping has been performed.
Mini-FAQ (frequently anticipated questions):
Q: Why do everything in one big, hard to review patch?
Q: Why add escaping in specific case FOO, it doesn't seem needed?
Because the goal here is to have "escape everywhere" as the default
policy, rather than identifying individual bugs and fixing them one
by one by adding escaping where needed. As such, this patch surely
introduces a lot of needless escaping. This is no different from
how Mako/Pylons HTML escape everything by default, even when not
needed: it's errs on the side of needless work, to prevent erring
on the side of skipping required (and security critical) work.
As for reviewability, the most important thing to notice is not where
escaping has been introduced, but any places where it might have been
missed (or where h.jshtml is needed, but h.js is used).
Q: The added escaping is kinda verbose/ugly.
That is not a question, but yes, I agree. Hopefully it'll encourage us
to move away from inline JavaScript altogether. That's a significantly
larger job, though; with luck this patch will keep us safe and secure
until such a time as we can implement the real fix.
Q: Why not use Mako filter syntax ("${val|h.js}")?
Because of long-standing Mako bug #140, preventing use of 'h' in
filters.
Q: Why not work around bug #140, or even use straight "${val|js}"?
Because Mako still applies the default h.escape filter before the
explicitly specified filters.
Q: Where do we go from here?
Longer term, we should stop doing variable expansions in script blocks,
and instead pass data to JS via e.g. data attributes, or asynchronously
using AJAX calls. Once we've done that, we can remove inline JavaScript
altogether in favor of separate script files, and set a strict Content
Security Policy explicitly blocking inline scripting, and thus also the
most common kind of cross-site scripting attack.
author | Søren Løvborg <sorenl@unity3d.com> |
---|---|
date | Tue, 28 Feb 2017 17:19:00 +0100 |
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 |