##// END OF EJS Templates
user edit: fix labels
user edit: fix labels

File last commit:

r3365:2dfefa38 beta
r3409:3c8d8725 beta
Show More
installation_win.rst
292 lines | 8.9 KiB | text/x-rst | RstLexer
/ docs / installation_win.rst
added detailed step-by-step installation instruction for windows
r2358 .. _installation_win:
Step by step Installation for Windows
=====================================
whitespace cleanup
r3224 RhodeCode step-by-step install Guide for Windows
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Target OS: Windows XP SP3 32bit English (Clean installation)
+ All Windows Updates until 24-may-2012
added detailed step-by-step installation instruction for windows
r2358
updated windows installation with note of 32 bit system used in example
r2838 .. note::
whitespace cleanup
r3224
updated windows installation with note of 32 bit system used in example
r2838 This installation is for 32bit systems, for 64bit windows you might need
installation win document updates
r3358 to download proper 64bit versions of the different packages(Windows Installer, Win32py extensions)
plus some extra tweaks.
These extra steps haven been marked as "64bit".
Tested on Windows Server 2008 R2 SP1, 9-feb-2013.
If you run into any 64bit related problems, please check these pages:
- http://blog.victorjabur.com/2011/06/05/compiling-python-2-7-modules-on-windows-32-and-64-using-msvc-2008-express/
- http://bugs.python.org/issue7511
updated windows installation with note of 32 bit system used in example
r2838
added detailed step-by-step installation instruction for windows
r2358 Step1 - Install Visual Studio 2008 Express
------------------------------------------
whitespace cleanup
r3224
Optional: You can also install MingW, but VS2008 installation is easier
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Download "Visual C++ 2008 Express Edition with SP1" from:
http://www.microsoft.com/visualstudio/en-us/products/2008-editions/express
(if not found or relocated, google for "visual studio 2008 express" for
updated link)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 You can also download full ISO file for offline installation, just
choose "All - Offline Install ISO image file" in the previous page and
choose "Visual C++ 2008 Express" when installing.
added detailed step-by-step installation instruction for windows
r2358
fixes #741 add note that VS2008 is the ONLY supported Visual Studio version
r3244 .. note::
Mads Kiilerich
coding style: fix trailing and leading spaces and tabs
r3267
sync docs changes from stable
r3365 Using other versions of Visual Studio will lead to random crashes.
You must use Visual Studio 2008!"
added detailed step-by-step installation instruction for windows
r2358
.. note::
sync docs changes from stable
r3365 Silverlight Runtime and SQL Server 2008 Express Edition are not
required, you can uncheck them
added detailed step-by-step installation instruction for windows
r2358
installation win document updates
r3358 .. note::
sync docs changes from stable
r3365
64bit: You also need to install the Microsoft Windows SDK for .NET 3.5 SP1 (.NET 4.0 won't work).
Download from: http://www.microsoft.com/en-us/download/details.aspx?id=3138
installation win document updates
r3358
.. note::
sync docs changes from stable
r3365
64bit: You also need to copy and rename a .bat file to make the Visual C++ compiler work.
I am not sure why this is not necessary for 32bit.
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
installation win document updates
r3358
added detailed step-by-step installation instruction for windows
r2358
Step2 - Install Python
----------------------
Install Python 2.x.y (x >= 5) x86 version (32bit). DO NOT USE A 3.x version.
whitespace cleanup
r3224 Download Python 2.x.y from:
http://www.python.org/download/
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Choose "Windows Installer" (32bit version) not "Windows X86-64
Installer". While writing this guide, the latest version was v2.7.3.
Remember the specific major and minor version installed, because it will
be needed in the next step. In this case, it is "2.7".
added detailed step-by-step installation instruction for windows
r2358
installation win document updates
r3358 .. note::
sync docs changes from stable
r3365
64bit: Just download and install the 64bit version of python.
added detailed step-by-step installation instruction for windows
r2358
Step3 - Install Win32py extensions
----------------------------------
whitespace cleanup
r3224
Download pywin32 from:
http://sourceforge.net/projects/pywin32/files/
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 - Click on "pywin32" folder
- Click on the first folder (in this case, Build 217, maybe newer when you try)
- Choose the file ending with ".win32-py2.x.exe" -> x being the minor
version of Python you installed (in this case, 7)
When writing this guide, the file was:
http://sourceforge.net/projects/pywin32/files/pywin32/Build%20217/pywin32-217.win32-py2.7.exe/download
added detailed step-by-step installation instruction for windows
r2358
installation win document updates
r3358 .. note::
sync docs changes from stable
r3365
64bit: Download and install the 64bit version.
At the time of writing you can find this at:
http://sourceforge.net/projects/pywin32/files/pywin32/Build%20218/pywin32-218.win-amd64-py2.7.exe/download
added detailed step-by-step installation instruction for windows
r2358
Step4 - Python BIN
------------------
whitespace cleanup
r3224 Add Python BIN folder to the path
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 You have to add the Python folder to the path, you can do it manually
(editing "PATH" environment variable) or using Windows Support Tools
that came preinstalled in Vista/7 and can be installed in Windows XP.
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 - Using support tools on WINDOWS XP:
If you use Windows XP you can install them using Windows XP CD and
navigating to \SUPPORT\TOOLS. There, execute Setup.EXE (not MSI).
added detailed step-by-step installation instruction for windows
r2358 Afterwards, open a CMD and type::
whitespace cleanup
r3224
SETX PATH "%PATH%;[your-python-path]" -M
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Close CMD (the path variable will be updated then)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 - Using support tools on WINDOWS Vista/7:
added detailed step-by-step installation instruction for windows
r2358
Open a CMD and type::
whitespace cleanup
r3224 SETX PATH "%PATH%;[your-python-path]" /M
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Please substitute [your-python-path] with your Python installation path.
Typically: C:\\Python27
added detailed step-by-step installation instruction for windows
r2358
Step5 - RhodeCode folder structure
----------------------------------
whitespace cleanup
r3224 Create a RhodeCode folder structure
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 This is only a example to install RhodeCode, you can of course change
it. However, this guide will follow the proposed structure, so please
later adapt the paths if you change them. My recommendation is to use
folders with NO SPACES. But you can try if you are brave...
added detailed step-by-step installation instruction for windows
r2358
Create the following folder structure::
whitespace cleanup
r3224 C:\RhodeCode
C:\RhodeCode\Bin
C:\RhodeCode\Env
C:\RhodeCode\Repos
added detailed step-by-step installation instruction for windows
r2358
Step6 - Install virtualenv
---------------------------
whitespace cleanup
r3224 Install Virtual Env for Python
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Navigate to: http://www.virtualenv.org/en/latest/index.html#installation
Right click on "virtualenv.py" file and choose "Save link as...".
Download to C:\\RhodeCode (or whatever you want)
(the file is located at
https://raw.github.com/pypa/virtualenv/master/virtualenv.py)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Create a virtual Python environment in C:\\RhodeCode\\Env (or similar). To
do so, open a CMD (Python Path should be included in Step3), navigate
where you downloaded "virtualenv.py", and write::
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 python virtualenv.py C:\RhodeCode\Env
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 (--no-site-packages is now the default behaviour of virtualenv, no need
to include it)
added detailed step-by-step installation instruction for windows
r2358
Step7 - Install RhodeCode
-------------------------
whitespace cleanup
r3224 Finally, install RhodeCode
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Close previously opened command prompt/s, and open a Visual Studio 2008
Command Prompt (**IMPORTANT!!**). To do so, go to Start Menu, and then open
"Microsoft Visual C++ 2008 Express Edition" -> "Visual Studio Tools" ->
"Visual Studio 2008 Command Prompt"
added detailed step-by-step installation instruction for windows
r2358
installation win document updates
r3358 .. note::
sync docs changes from stable
r3365
64bit: For 64bit you need to modify the shortcut that is used to start the
Visual Studio 2008 Command Prompt. Use right-mouse click to open properties.
installation win document updates
r3358 Change commandline from::
%comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" x86
to::
%comspec% /k ""C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\vcvarsall.bat"" amd64
added detailed step-by-step installation instruction for windows
r2358 In that CMD (loaded with VS2008 PATHs) type::
whitespace cleanup
r3224
cd C:\RhodeCode\Env\Scripts (or similar)
activate
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 The prompt will change into "(Env) C:\\RhodeCode\\Env\\Scripts" or similar
(depending of your folder structure). Then type::
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 pip install rhodecode
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 (long step, please wait until fully complete)
added detailed step-by-step installation instruction for windows
r2358
Some warnings will appear, don't worry as they are normal.
Step8 - Configuring RhodeCode
-----------------------------
whitespace cleanup
r3224 steps taken from http://packages.python.org/RhodeCode/setup.html
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 You have to use the same Visual Studio 2008 command prompt as Step7, so
if you closed it reopen it following the same commands (including the
added detailed step-by-step installation instruction for windows
r2358 "activate" one). When ready, just type::
whitespace cleanup
r3224
cd C:\RhodeCode\Bin
paster make-config RhodeCode production.ini
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Then, you must edit production.ini to fit your needs (ip address, ip
port, mail settings, database, whatever). I recommend using NotePad++
(free) or similar text editor, as it handles well the EndOfLine
character differences between Unix and Windows
(http://notepad-plus-plus.org/)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 For the sake of simplicity lets run it with the default settings. After
your edits (if any), in the previous Command Prompt, type::
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 paster setup-rhodecode production.ini
(this time a NEW database will be installed, you must follow a different
step to later UPGRADE to a newer RhodeCode version)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 The script will ask you for confirmation about creating a NEW database,
answer yes (y)
The script will ask you for repository path, answer C:\\RhodeCode\\Repos
(or similar)
The script will ask you for admin username and password, answer "admin"
+ "123456" (or whatever you want)
The script will ask you for admin mail, answer "admin@xxxx.com" (or
whatever you want)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 If you make some mistake and the script does not end, don't worry, start
it again.
added detailed step-by-step installation instruction for windows
r2358
Step9 - Running RhodeCode
-------------------------
whitespace cleanup
r3224 In the previous command prompt, being in the C:\\RhodeCode\\Bin folder,
added detailed step-by-step installation instruction for windows
r2358 just type::
whitespace cleanup
r3224
paster serve production.ini
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Open yout web server, and go to http://127.0.0.1:5000
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 It works!! :-)
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 Remark:
If it does not work first time, just Ctrl-C the CMD process and start it
again. Don't forget the "http://" in Internet Explorer
added detailed step-by-step installation instruction for windows
r2358
What this Guide does not cover:
whitespace cleanup
r3224 - Installing Celery
added detailed step-by-step installation instruction for windows
r2358 - Running RhodeCode as Windows Service. You can investigate here:
whitespace cleanup
r3224
- http://pypi.python.org/pypi/wsgisvc
- http://ryrobes.com/python/running-python-scripts-as-a-windows-service/
- http://wiki.pylonshq.com/display/pylonscookbook/How+to+run+Pylons+as+a+Windows+service
added detailed step-by-step installation instruction for windows
r2358
- Using Apache. You can investigate here:
whitespace cleanup
r3224 - https://groups.google.com/group/rhodecode/msg/c433074e813ffdc4
added detailed step-by-step installation instruction for windows
r2358
Upgrading
=========
whitespace cleanup
r3224
Stop running RhodeCode
added detailed step-by-step installation instruction for windows
r2358 Open a CommandPrompt like in Step7 (VS2008 path + activate) and type::
whitespace cleanup
r3224
easy_install -U rhodecode
cd \RhodeCode\Bin
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 { backup your production.ini file now} ::
added detailed step-by-step installation instruction for windows
r2358
whitespace cleanup
r3224 paster make-config RhodeCode production.ini
added detailed step-by-step installation instruction for windows
r2358
(check changes and update your production.ini accordingly) ::
whitespace cleanup
r3224
added detailed step-by-step installation instruction for windows
r2358 paster upgrade-db production.ini (update database)
whitespace cleanup
r3224 Full steps in http://packages.python.org/RhodeCode/upgrade.html