Setup of Development Environment for Ubuntu
Required software
Bazaar
apt-get install bzr
Mono 2.x
- This has been tested on Ubuntu Oneiric (11.10):
- apt-get install mono-runtime mono-xbuild mono-gmcs
- if you get this error: ICSharpCode.SharpZipLib.Tar.TarArchive does not contain a definition for Close
- solution: sudo gacutil -u ICSharpCode.SharpZipLib; sudo gacutil --install csharp/ThirdParty/ICSharpCode/ICSharpCode.SharpZipLib.dll
- If you want to install a certain mono-version (eg. 2.6.7) you can find them here
NAnt
- on Ubuntu/Debian: apt-get install nant
- Problem: NAnt 0.91 Alpha that comes with Ubuntu Oneiric (11.10) has conflicts with finding elements in 2.0 and 4.0 System dlls.
- Solution: copy the latest final NAnt 0.91 release zip from sourceforge (http://downloads.sourceforge.net/project/nant/nant/0.91/nant-0.91-bin.tar.gz), unzip, and change /usr/bin/nant to point at the latest NAnt.exe
SQLite or PostgreSQL or MySQL
- apt-get install sqlite3 (requires 3.6.1 or higher; might need to use another repository, eg testing)
- or apt-get install postgresql
- or apt-get install mysql-server
xgettext and msgfmt
- apt-get install gettext
dos2unix
- this is needed for building releases (nant buildRelease)
- apt-get install tofrodos
Get the source code
The source code is managed with Bazaar.
Follow the instructions at How to work with bazaar on the command line to get the source code.
Please have a look at the following page: Submitting patches and features!
Configuration of Development Environment
Please check your OpenPetra.build.config file and make sure the paths are all adjusted to your system and the version numbers in the paths are correct.
This OpenPetra.build.config file is also the file where you set the database you want to use. If you want to switch the database system later, see Setup_of_Development_environment#Use_another_database_system.
NAnt script
There is a central NAnt script that is able to generate a lot of code and is able to do all automated tasks in the OpenPetra project.
Please see OpenPetra NAnt script for details
If you want to switch from SQLite to PostgreSQL which we recommend for serious development, please follow the instructions at Setup_of_Development_environment#Use_another_database_system.