67 lines
1.9 KiB
Plaintext
67 lines
1.9 KiB
Plaintext
==============
|
|
LodgeIt Readme
|
|
==============
|
|
|
|
Lodgeit implements a pastebin and some scripts to paste the service.
|
|
|
|
|
|
Installation
|
|
~~~~~~~~~~~~
|
|
|
|
LodgeIt requires at least Python 2.5 to work correctly. Next to this LodgeIt has
|
|
quite a few of dependencies as well as a nice bootstrap process. This is documented
|
|
on the following slides.
|
|
|
|
Dependencies and virtual environment
|
|
====================================
|
|
|
|
To get LodgeIt work properly we need those dependencies: Python (at least 2.5),
|
|
python-setuptools and git.
|
|
|
|
For Ubuntu (or any Debian based distribution) use ``aptitude`` to install::
|
|
|
|
aptitude install python-dev python-setuptools python-virtualenv git
|
|
|
|
Now we can install LodgeIt. But first we need to clone LodgeIt from the
|
|
git repository. To do that you create a new folder ``lodgeit-dev`` in your
|
|
projects directory and change into it. There we initialize the virtual
|
|
environment and clone LodgeIt::
|
|
|
|
git clone https://git.openstack.org/openstack-infra/lodgeit
|
|
|
|
Right before we can initialize the virtual environment we need to install some
|
|
development packages to compile the python imaging library.
|
|
|
|
For Ubuntu again ``aptitude`` (as root)::
|
|
|
|
sudo aptitude install build-essential
|
|
apt-get build-dep python-imaging
|
|
|
|
Now it's possible to install the virtual environment. This is done with a simple
|
|
Python command::
|
|
|
|
# assumed that you are located in lodgeit-dev/lodgeit
|
|
python scripts/make-bootstrap.py > ../bootstrap.py
|
|
cd ..
|
|
# make sure that the virtualenv is not activated. If yes, execute `deactivate`
|
|
python bootstrap.py .
|
|
|
|
You are ready to run now.
|
|
|
|
Database and other things
|
|
=========================
|
|
|
|
We are now ready to enter the virtual environment (assumed you are located in
|
|
``lodgeit-dev/lodgeit``)::
|
|
|
|
. ../bin/activate
|
|
|
|
LodgeIt initializes it's database per default on /tmp/lodgeit.db, you can change
|
|
that path in the manage.py by modifying ``dburi``.
|
|
|
|
Now start the development server::
|
|
|
|
python manage.py runserver
|
|
|
|
Enjoy!
|