Deploying the app

Jump to bottom Edit New page

Luthaf edited this page Oct 16, 2014 · 6 revisions

Web server installation

This app can be deployed on a web server using the same way than every other Django application. The official documentation is a good starting point.

Some specific steps are listed here:

Be sure you have installed git, patacrep, a song database, TeXLive and Lilypond on your server.
Set the SONGS_LIBRARY_DIR = '/PATH/TO/THE/MAIN/SONGS/REPOSITORY/ value in the local_settings.py file.
Set the database connection informations in local_settings.py

As for a development installation, you can now initialise the database

python manage.py migrate
make sure your locale is not "C", this may cause a failure during songs import
import the songs from the repository to the database with: python manage.py importsongs

Background workers

You should find a way to launch the PDF generation process in the background. The songbook_bg_tasks_worker script can be used for this purpose.

Specific issues

On CentOS 6.5 , some packages are too old. You should install them directly.

TeXLive should be installed with the more recent version, or you can manually add the missing packages
Ghostscipt (GPL Ghostscript 8.70) is too old to build lilypond music sheets. You have to install Ghostscript 9.x