Created on Sept. 23, 2012, 12:49 a.m. by Hevok & updated on Feb. 10, 2013, 2:26 a.m. by Hevok
If your current operating system is Windows it is recommend to either get a Linux-like environment (e.g. extend the console with Cywing) or better get <a href="http://www.ubuntu.com/download/desktop/windows-installer">]Wubi</a> (Windows Ubuntu Installer) as a dual boot system. The latter one is very straightforward.
¶
¶
In order to set up a local development version of Denigma on Windows do the following steps:
¶
¶
1. Install your Developer version of Denigma
¶
¶
First we get GIT, the cat [http://msysgit.github.com/]. For instance from here [http://denigma.de/url/3q].
¶
The installation will ask to choose:
¶
¶
a) use Git Bash only
¶
b) run Git from windows command prompt
¶
c) run Git and included Unix tools from windows command prompt
¶
¶
Select c).
¶
¶
Then open the command prompt, navigate to a folder where the Project shall live and run the following command:
¶
¶
git clone https://github.com/hevok/denigma
¶
¶
2. Preparing Denigma Programming Environment
¶
¶
i) Installing Python:
¶
¶
Install Python at first if you haven not yet [http://www.python.org/].
¶
We are going with latest version of Python 2 (i.e. 2.7.3), as Python 3 is not yet well established. Many libraries are still in stage 2. So with Python 3 you would have a much smaller application ecosystem.
¶
¶
If you are on a 64bit machine install the following executable [http://www.python.org/ftp/python/2.7.3/python-2.7.3.amd64.msi] under preferentially C:\Python27\
.
¶
¶
ii) Set Environment Variables:
¶
¶
Next step is to set the environment variables. For this follow: Start
> Control Panel
> Double click on System Icon
System Properties. There under system variables edit PATH
and include in the front the following string: C:\Python27\;C:\Python27\Scripts\
.
¶
¶
iii) Install PyCharm:
¶
¶
Then install a Interactive Development Environment for Python and Django [http://www.denigma.de/tutorials/77/view/].
¶
¶
3. Configuring Virtual Environment:
¶
¶
Download the latest easy Installer for Windows that fits the installed Python version (e.g. the exe at the bottom of [http://pypi.python.org/pypi/setuptools]) and install it.
¶
¶
If you are on a 64bit machine consider to download ez_setup.py
, copy it to C:\Python27
, navigate into this folder in the DOS prompt and install it by running python ez_setup.py
[http://peak.telecommunity.com/dist/ez_setup.py].
¶
¶
Open a new DOS prompt and run easy_install pip
as well as pip install virtualenv
.
¶
¶
Finally, navigate to the Denigma Project folder and create a virtual environment:
¶
¶
virtualenv env --system-site packages
¶
OR
¶
python virtualenv.py env --system-site packages # only if virtualenv installation failed
¶
¶
C:\dev\denigma\env\Scripts\activate
¶
¶
¶
4. Starting Denigma:
¶
¶
Now its time to prepare Denigma for running.
¶
First install some prerequisites:
¶
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#Numpy] numpy-MKL-1.7.0rc1.win-amd64-py2.7.exe]
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#Biopython] biopython-1.60.win-amd64-py2.7.exe]
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#PyCogent] cogent-1.5.3.win-amd64-py2.7.exe
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#PIL] PIL-1.1.7.win-amd64-py2.7.exe
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#mysql-python] MySQL-python-1.2.4.win-amd64-py2.7.exe
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#ReportLab] Reportlab-2.5.win-amd64-py2.7.exe
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#Greenlet] greenlet-0.4.0.win-amd64-py2.7.exe
¶
* [http://www.lfd.uci.edu/~gohlke/pythonlibs/#Gevent] gevent-0.13.8.win-amd64-py2.7.exe
¶
¶
Then install all the other required libraries:
¶
¶
pip install -r denigma/requirements/project.txt
¶
¶
python manage.py syncdb --all
¶
python manage.py migrate --fake
¶
python manage.py runserver
¶
¶
Open localhost:8000
in the browser and it is accomplished.
¶
¶
5. Modify Denigma:
¶
¶
i) modify locally
¶
¶
git add modified_file
¶
git commit -m "Describe the change here"
¶
¶
ii) upload you modification to the online Denigma
¶
¶
git push
¶
¶
6. Keep Denigma updated
¶
¶
Regularly pull any Changes in Denigma source code:
¶
¶
git pull
¶
¶
¶
Comment on This Data Unit