Confirmed users
514
edits
| Line 15: | Line 15: | ||
= How to start = | = How to start = | ||
''' | ''We do work on github, but certainly we don't want to limit the user experience to github only. Feel free to use the server you like the most.'' | ||
== Installation == | |||
Based on | |||
[http://erikvold.com/blog/index.cfm/2010/12/13/installing-flightdeck-on-osx Erik's blog]. Aiming to work on any Un*x systems - a few commands may be different - Ubuntu commands are used. I assume if any other distro is used user already knows how to use it. | |||
=== Requirements === | |||
* Python 2.6 | |||
* Git | |||
* MySQL | |||
* database `flightdeck-db`, with all privileges granted to `flightdeck-user` | |||
=== Prepare the repository === | |||
* Create github account | |||
* Fork from the official [http://github.com/mozilla/FlightDeck main repository] | |||
=== Prepare the system === | |||
'''Install needed dev packages''' | |||
sudo apt-get build-dep python-mysqldb libxslt-dev libxml2-dev | |||
sudo easy_install pip | |||
sudo pip install virtualenvwrapper | |||
sudo pip install virtualenv | |||
'' | '''Prepare virtual environment''' | ||
echo "export WORKON_HOME=~/Envs" > ~/.virtualenvwrapper.sh | |||
echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.virtualenvwrapper.sh | |||
# OSX | |||
echo "source ~/.virtualenvwrapper.sh" >> ~/.bash_profile | |||
# Ubuntu | |||
echo "source ~/.virtualenvwrapper.sh" >> ~/.bashrc | |||
source ~/.virtualenvwrapper.sh | |||
mkvirtualenv --no-site-packages flightdeck | |||
=== Install repository === | |||
'''Clone''' | |||
git clone https://github.com/{your_github_username}/FlightDeck.git | |||
git remote add main https://github.com/mozilla/FlightDeck.git | |||
git submodule update --init | |||
'''Install required software to virtual environment''' | |||
pip install simplejson | |||
pip install mysql-python | |||
cd FlightDeck | |||
pip install -r requirements/development.txt | |||
'''Configure your local settings''' | |||
Copy contents of [http://pastebin.mozilla.org/1020232 that file] to ./settings_local.py, change the password to the database. | |||
'''Test the configuration''' | |||
''The only test which may fail is the authentication against AMO database. To test this bug one needs to be under Mozilla's VPN and have access to AMO database configured in settings_local.py file.'' | |||
./manage.py test | |||
= How to commit = | = How to commit = | ||