Testing:Linux Testing Environment
From OpenLP
Contents |
Verify Installation
To verify the installation checkout the source code of OpenLP and run the following script:
python OPENLP_SRC/scripts/check_dependencies.py
The output should be similar to the following:
Python >= 2.6 ... 2.7.0.final.0 Checking for modules... PyQt4... OK PyQt4.QtCore... OK PyQt4.QtGui... OK PyQt4.QtNetwork... OK PyQt4.QtOpenGL... OK PyQt4.QtSvg... OK PyQt4.QtTest... OK PyQt4.QtWebKit... OK PyQt4.phonon... OK sqlalchemy... OK sqlite3... OK lxml... OK chardet... OK enchant... OK BeautifulSoup... OK mako... OK Checking for optional modules... sqlite (SQLite 2 support)... FAIL MySQLdb (MySQL support)... OK psycopg2 (PostgreSQL support)... OK Verifying version of modules... PyQt4 >= 4.6 ... 4.8.3 Qt4 >= 4.6 ... 4.7.3 sqlalchemy >= 0.5 ... 0.6.8 enchant >= 1.3 ... 1.3.1 Qt4 image formats... read: bmp, gif, ico, jpeg, jpg, mng, pbm, pgm, png, ppm, svg, svgz, tif, tiff, xbm, xpm write: bmp, ico, jpeg, jpg, png, ppm, tif, tiff, xbm, xpm Enchant (spell checker)... available backends: myspell, aspell available languages: en_HK, en_GB, en_TT, en_NG, en_BW, en_IN, en_BZ, en_AG, en_BS, en_CA, en_PH, en_US, en_NA, en_JM, en_ZW, en_DK, en_GH, en_ZA, en_IE, en_SG, en_AU, en_NZ, cs, en
Installing on Kubuntu
Warning: Kubuntu-specific Section
This section is written by a Kubuntu user with Kubuntu (or one of it's siblings, such as Ubuntu and Xubuntu) in mind. Thus, he liberally uses aptitude, and assumes that everything will work exactly the same for you.
If you don't run Kubuntu (or one of it's siblings), it won't work, so look for the section on this page that deals with your specific Linux distribution.
OpenLP is supported on Ubuntu 10.04 and up.
Install Dependency Packages
user@linux:~ $ sudo apt-get install python-setuptools python-support python \
qt4-dev-tools python-qt4 python-qt4-phonon python-sqlalchemy \
python-chardet python-beautifulsoup python-lxml python-sqlite \
python-enchant python-mako python-migrate python-qt4-gl
Ubuntu Notes
At the time of writing, there are known problems with media for some Gnome installations.
Installing libxine-ffmpeg and/or phonon-backend-gstreamer might help with these. You may also need to remove phonon-backend-xine Installing kubuntu-restricted-extras has been reported to fix the media issues for regular Ubuntu 10.04 (gnome) installs. The ubuntu-restricted-extras meta-package is also needed.
Installing on Fedora
Warning: Fedora-specific Section
This section is written by a Fedora user with Fedora in mind. Thus, he liberally uses pkcon, and assumes that everything will work exactly the same for you.
If you don't run Fedora, it won't work, so look for the section on this page that deals with your specific Linux distribution.
Install Qt 4
The recommended version of Qt4 is version 4.4.0 or higher
Version 4.4.3 is the default version of Qt 4 on Fedora 10. If you don't have KDE or Qt4 installed, you'll need to install it with the following command:
user@linux:~ $ pkcon install qt-x11
Install PyQt4
The recommended version of PyQt4 is version 4.4.0 or higher
Version 4.4.3 is the default version of PyQt4 on Fedora 10. If you're using a previous version of Fedora, you'll need to make sure you get hold of version 4.4.0. You can install PyQt4 with the following command:
user@linux:~ $ pkcon install PyQT4
Install SQLAlchemy
The recommended version of SQLAlchemy is version 0.5 or higher
Installing SQLAlchemy on Fedora is a very simple affair:
user@linux:~ $ pkcon install python-sqlalchemy
Install Chardet
To get the bibles to work with the unicode settings Chardet is required
Installing Chardet on Fedora is a very simple affair:
user@linux:~ $ pkcon install python-chardet
Install BeautifulSoup
To get the bibles to work with the unicode settings BeautifulSoup HTTP parser is required
Installing BeautifulSoup on Fedora is a very simple affair:
user@linux:~ $ pkcon install python-BeautifulSoup
Install Phonon
To allow the media plugin to function
Installing Phonon on Fedora is a very simple affair:
user@linux:~ $ pkcon install phonon
You also need python-enchant and python-lxml
user@linux:~ $ pkcon install python-enchant python-lxml
Installing on Mandriva
Warning: Mandriva-specific Section This section is written by a Mandriva user with Mandriva in mind. Thus, he liberally uses urpmi, and assumes that everything will work exactly the same for you. If you don't run Mandriva, it won't work, so look for the section on this page that deals with your specific Linux distribution. This is specifically for Mandriva 2010.1 Beta2 KDE, 2010.0 does not have some of the required packages. Since 2010.1 is not at final release these instructions could change.
Installing setuptools
setuptools is needed to install some packages not included in Mandriva.
user@linux:~ urpmi python-setuptools
Install chardet and SQLAlchemy
To install chardet and SQLAlchemy we must use easy_install as root
user@linux:~ easy_install chardet user@linux:~ easy_install SQLAlchemy
Install lxml and beautifulsoup
user@linux:~ urpmi python-lxml python-beautifulsoup
Install phonon
user@linux:~ urpmi phonon -a
This will install all the phonon packages. These are required to get OpenLP up and running.
Installing on OpenSUSE
Warning: openSUSE-specific Section
This section is written by an openSUSE user with openSUSE in mind. Thus, he liberally uses zypper, and assumes that everything will work exactly the same for you.
If you don't run openSUSE, it won't work, so look for the section on this page that deals with your specific Linux distribution.
Warning!!!!: The python-qt4 packages in OpenSUSE versions prior to 12.1 do not support Phonon so OpenLP will not run. If you want to run OpenLP on OpenSUSE you should upgrade to 12.1
These instructions assume you're running OpenSUSE 12.1 with KDE as you're main desktop environment. There are two methods for installing OpenLP on OpenSuse. The first is to use 1-click install through YaST. The other is to use zypper to add the proper repository and install openlp
Installing from a package (RPM)
One Click Install
Click the appropriate link below for your version of OpenSUSE and follow the YaST Wizard.
Command Line Method
OpenSUSE 12.1
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper install OpenLP
Installing Development version from Bazaar or nightly tarballs
Warning!!!!: While it generally works there is no guarantee that any particular version from bazaar won't break everything. If you just need something that works reliably use the packages as described above. Use at your own risk. Use this method if you want to run the development version of openLP from bazaar or from a nightly tarball. This method will install all of the dependencies necessary to run OpenLP from the OpenSUSE repositories through zypper. Once you have completed the steps below for your version of OpenSUSE follow the instructions on the Testing:Getting Started page.
user@opensuse:~ $ sudo zypper addrepo obs://devel:languages:python/openSUSE_12.1 python-obs user@opensuse:~ $ sudo zypper install phonon python-beautifulsoup python-chardet python-enchant python-lxml python-mako python-sqlalchemy python-sqlalchemy-migrate python-qt4 hicolor-icon-theme libreoffice-impress libreoffice-pyuno
