Mercurial > kallithea

annotate docs/installation_win.rst @ 2838:ba09e335f266 beta

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated windows installation with note of 32 bit system used in example
author Marcin Kuzminski <marcin@python-works.com>
date Thu, 13 Sep 2012 21:14:11 +0200
parents 69df04ee1e2b
children 8b8edfc25856 1a498b11f154
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2358
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
1 .. _installation_win:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
2
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
3
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
4 Step by step Installation for Windows
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
5 =====================================
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
6
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
7
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
8 RhodeCode step-by-step install Guide for Windows
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
9
2838
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
10 Target OS: Windows XP SP3 32bit English (Clean installation)
2358
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
11 + All Windows Updates until 24-may-2012
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
12
2838
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
13 .. note::
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
14
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
15 This installation is for 32bit systems, for 64bit windows you might need
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
16 to download proper 64bit version of "Windows Installer" and Win32py
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
17 extensions
ba09e335f266 updated windows installation with note of 32 bit system used in example
Marcin Kuzminski <marcin@python-works.com>
parents: 2358
diff changeset
18
2358
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
19 Step1 - Install Visual Studio 2008 Express
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
20 ------------------------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
21
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
22
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
23 Optional: You can also install MingW, but VS2008 installation is easier
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
24
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
25 Download "Visual C++ 2008 Express Edition with SP1" from:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
26 http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
27 (if not found or relocated, google for "visual studio 2008 express" for
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
28 updated link)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
29
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
30 You can also download full ISO file for offline installation, just
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
31 choose "All - Offline Install ISO image file" in the previous page and
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
32 choose "Visual C++ 2008 Express" when installing.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
33
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
34
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
35 .. note::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
36
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
37 Silverlight Runtime and SQL Server 2008 Express Edition are not
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
38 required, you can uncheck them
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
39
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
40
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
41 Step2 - Install Python
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
42 ----------------------
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 Install Python 2.x.y (x >= 5) x86 version (32bit). DO NOT USE A 3.x version.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
45 Download Python 2.x.y from:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
46 http://www.python.org/download/
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
47
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
48 Choose "Windows Installer" (32bit version) not "Windows X86-64
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
49 Installer". While writing this guide, the latest version was v2.7.3.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
50 Remember the specific major and minor version installed, because it will
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
51 be needed in the next step. In this case, it is "2.7".
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
52
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
53
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
54 Step3 - Install Win32py extensions
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
55 ----------------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
56
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
57 Download pywin32 from:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
58 http://sourceforge.net/projects/pywin32/files/
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
59
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
60 - Click on "pywin32" folder
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
61 - Click on the first folder (in this case, Build 217, maybe newer when you try)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
62 - Choose the file ending with ".win32-py2.x.exe" -> x being the minor
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
63 version of Python you installed (in this case, 7)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
64 When writing this guide, the file was:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
65 http://sourceforge.net/projects/pywin32/files/pywin32/Build%20217/pywin32-217.win32-py2.7.exe/download
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
66
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
67
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
68 Step4 - Python BIN
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
69 ------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
70
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
71 Add Python BIN folder to the path
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
72
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
73 You have to add the Python folder to the path, you can do it manually
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
74 (editing "PATH" environment variable) or using Windows Support Tools
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
75 that came preinstalled in Vista/7 and can be installed in Windows XP.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
76
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
77 - Using support tools on WINDOWS XP:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
78 If you use Windows XP you can install them using Windows XP CD and
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
79 navigating to \SUPPORT\TOOLS. There, execute Setup.EXE (not MSI).
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
80 Afterwards, open a CMD and type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
81
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
82 SETX PATH "%PATH%;[your-python-path]" -M
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
83
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
84 Close CMD (the path variable will be updated then)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
85
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
86 - Using support tools on WINDOWS Vista/7:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
87
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
88 Open a CMD and type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
89
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
90 SETX PATH "%PATH%;[your-python-path]" /M
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
91
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
92 Please substitute [your-python-path] with your Python installation path.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
93 Typically: C:\\Python27
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
94
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
95
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
96 Step5 - RhodeCode folder structure
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
97 ----------------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
98
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
99 Create a RhodeCode folder structure
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
100
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
101 This is only a example to install RhodeCode, you can of course change
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
102 it. However, this guide will follow the proposed structure, so please
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
103 later adapt the paths if you change them. My recommendation is to use
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
104 folders with NO SPACES. But you can try if you are brave...
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
105
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
106 Create the following folder structure::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
107
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
108 C:\RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
109 C:\RhodeCode\Bin
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
110 C:\RhodeCode\Env
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
111 C:\RhodeCode\Repos
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
112
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
113
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
114 Step6 - Install virtualenv
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
115 ---------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
116
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
117 Install Virtual Env for Python
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
118
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
119 Navigate to: http://www.virtualenv.org/en/latest/index.html#installation
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
120 Right click on "virtualenv.py" file and choose "Save link as...".
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
121 Download to C:\\RhodeCode (or whatever you want)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
122 (the file is located at
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
123 https://raw.github.com/pypa/virtualenv/master/virtualenv.py)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
124
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
125 Create a virtual Python environment in C:\\RhodeCode\\Env (or similar). To
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
126 do so, open a CMD (Python Path should be included in Step3), navigate
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
127 where you downloaded "virtualenv.py", and write::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
128
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
129 python virtualenv.py C:\RhodeCode\Env
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
130
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
131 (--no-site-packages is now the default behaviour of virtualenv, no need
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
132 to include it)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
133
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
134
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
135 Step7 - Install RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
136 -------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
137
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
138 Finally, install RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
139
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
140 Close previously opened command prompt/s, and open a Visual Studio 2008
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
141 Command Prompt (**IMPORTANT!!**). To do so, go to Start Menu, and then open
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
142 "Microsoft Visual C++ 2008 Express Edition" -> "Visual Studio Tools" ->
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
143 "Visual Studio 2008 Command Prompt"
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
144
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
145 In that CMD (loaded with VS2008 PATHs) type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
146
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
147 cd C:\RhodeCode\Env\Scripts (or similar)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
148 activate
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
149
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
150 The prompt will change into "(Env) C:\\RhodeCode\\Env\\Scripts" or similar
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
151 (depending of your folder structure). Then type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
152
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
153 pip install rhodecode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
154
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
155 (long step, please wait until fully complete)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
156
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
157 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
158
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
159
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
160 Step8 - Configuring RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
161 -----------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
162
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
163
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
164 steps taken from http://packages.python.org/RhodeCode/setup.html
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
165
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
166 You have to use the same Visual Studio 2008 command prompt as Step7, so
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
167 if you closed it reopen it following the same commands (including the
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
168 "activate" one). When ready, just type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
169
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
170 cd C:\RhodeCode\Bin
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
171 paster make-config RhodeCode production.ini
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
172
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
173 Then, you must edit production.ini to fit your needs (ip address, ip
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
174 port, mail settings, database, whatever). I recommend using NotePad++
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
175 (free) or similar text editor, as it handles well the EndOfLine
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
176 character differences between Unix and Windows
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
177 (http://notepad-plus-plus.org/)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
178
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
179 For the sake of simplicity lets run it with the default settings. After
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
180 your edits (if any), in the previous Command Prompt, type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
181
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
182 paster setup-rhodecode production.ini
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
183
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
184 (this time a NEW database will be installed, you must follow a different
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
185 step to later UPGRADE to a newer RhodeCode version)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
186
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
187 The script will ask you for confirmation about creating a NEW database,
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
188 answer yes (y)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
189 The script will ask you for repository path, answer C:\\RhodeCode\\Repos
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
190 (or similar)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
191 The script will ask you for admin username and password, answer "admin"
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
192 + "123456" (or whatever you want)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
193 The script will ask you for admin mail, answer "admin@xxxx.com" (or
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
194 whatever you want)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
195
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
196 If you make some mistake and the script does not end, don't worry, start
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
197 it again.
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
198
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
199
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
200 Step9 - Running RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
201 -------------------------
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
202
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
203
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
204 In the previous command prompt, being in the C:\\RhodeCode\\Bin folder,
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
205 just type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
206
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
207 paster serve production.ini
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
208
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
209 Open yout web server, and go to http://127.0.0.1:5000
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
210
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
211 It works!! :-)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
212
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
213 Remark:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
214 If it does not work first time, just Ctrl-C the CMD process and start it
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
215 again. Don't forget the "http://" in Internet Explorer
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
216
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
217
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
218
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
219 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
220
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
221 - Installing Celery
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
222 - Running RhodeCode as Windows Service. You can investigate here:
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
223
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
224 - http://pypi.python.org/pypi/wsgisvc
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
225 - http://ryrobes.com/python/running-python-scripts-as-a-windows-service/
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
226 - http://wiki.pylonshq.com/display/pylonscookbook/How+to+run+Pylons+as+a+Windows+service
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
227
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
228 - 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
229
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
230 - https://groups.google.com/group/rhodecode/msg/c433074e813ffdc4
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
231
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
232
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
233 Upgrading
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
234 =========
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
235
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
236 Stop running RhodeCode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
237 Open a CommandPrompt like in Step7 (VS2008 path + activate) and type::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
238
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
239 easy_install -U rhodecode
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
240 cd \RhodeCode\Bin
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
241
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
242 { backup your production.ini file now} ::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
243
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
244 paster make-config RhodeCode production.ini
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
245
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
246 (check changes and update your production.ini accordingly) ::
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
247
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
248 paster upgrade-db production.ini (update database)
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
249
69df04ee1e2b added detailed step-by-step installation instruction for windows
Marcin Kuzminski <marcin@python-works.com>
parents:
diff changeset
250 Full steps in http://packages.python.org/RhodeCode/upgrade.html