| 1 | PrimaGIS buildout for Debian based systems |
|---|
| 2 | ===================================== |
|---|
| 3 | |
|---|
| 4 | A large part of PrimaGIS's dependencies can be satisfied with system |
|---|
| 5 | packages which will dramatically reduce the time to execute the |
|---|
| 6 | buildout. This document describes the process of using system packages |
|---|
| 7 | on a Debian based Linux distribution. |
|---|
| 8 | |
|---|
| 9 | Supported distributions |
|---|
| 10 | ----------------------- |
|---|
| 11 | |
|---|
| 12 | The buildout is known to work on the following distributions: |
|---|
| 13 | |
|---|
| 14 | - Debian unstable (sid) |
|---|
| 15 | - Debian 4.0 (etch) |
|---|
| 16 | - Ubuntu 7.04 |
|---|
| 17 | |
|---|
| 18 | It may also work on other distributions that provide the same set of |
|---|
| 19 | packages. |
|---|
| 20 | |
|---|
| 21 | |
|---|
| 22 | Required packages |
|---|
| 23 | ----------------- |
|---|
| 24 | |
|---|
| 25 | Below is a list of packages that need to be installed before executing |
|---|
| 26 | the buildout: |
|---|
| 27 | |
|---|
| 28 | libpng-dev |
|---|
| 29 | libungif4-dev |
|---|
| 30 | libjpeg-dev |
|---|
| 31 | libtiff-dev |
|---|
| 32 | libfreetype6-dev |
|---|
| 33 | libgd2-noxpm-dev | libgd2-xpm-dev |
|---|
| 34 | libcurl3-gnutls-dev |
|---|
| 35 | libz-dev |
|---|
| 36 | libreadline-dev |
|---|
| 37 | libgdal-dev |
|---|
| 38 | libgeos-dev |
|---|
| 39 | libxerces27-dev |
|---|
| 40 | swig |
|---|
| 41 | bison |
|---|
| 42 | flex |
|---|
| 43 | sed |
|---|
| 44 | build-essential |
|---|
| 45 | python-gdal |
|---|
| 46 | python-psycopg2 |
|---|
| 47 | python-imaging |
|---|
| 48 | python-elementtree | python-celementtree |
|---|
| 49 | python2.4-dev |
|---|
| 50 | autoconf |
|---|
| 51 | automake |
|---|
| 52 | |
|---|
| 53 | ---------- |
|---|
| 54 | You can run(Tested on Ubuntu 7.04): |
|---|
| 55 | |
|---|
| 56 | sudo apt-get install libpng-dev libungif4-dev libjpeg-dev libtiff-dev libfreetype6-dev libgd2-noxpm-dev libcurl3-gnutls-dev libz-dev libreadline-dev libgdal-dev libgeos-dev swig bison flex sed build-essential python-gdal python-psycopg2 python-imaging python-elementtree python2.4-dev autoconf automake libxerces27-dev |
|---|
| 57 | |
|---|
| 58 | If you have non-standard repositories you may need to adjust the package names to specific versions. |
|---|
| 59 | |
|---|
| 60 | Example Error and Fix: |
|---|
| 61 | Package libpng-dev is a virtual package provided by: |
|---|
| 62 | libpng12-dev 1.2.15~beta5-1ubuntu1 |
|---|
| 63 | You should explicitly select one to install. |
|---|
| 64 | |
|---|
| 65 | Change libpng-dev to libpng12-dev in the apt-get command above |
|---|
| 66 | |
|---|
| 67 | ---------- |
|---|
| 68 | |
|---|
| 69 | This list of packages will pull in the rest of the requirements |
|---|
| 70 | through their dependencies. |
|---|
| 71 | |
|---|
| 72 | If you are familiar with your distribution's packaging system you may |
|---|
| 73 | swap a package with another as long as it provides the same basic |
|---|
| 74 | functionality, e.g. changing libgd's noxpm version with the xpm |
|---|
| 75 | version. |
|---|
| 76 | |
|---|
| 77 | |
|---|
| 78 | Running the buildout |
|---|
| 79 | -------------------- |
|---|
| 80 | |
|---|
| 81 | The buildout is run by: |
|---|
| 82 | |
|---|
| 83 | $ ./bin/buildout -c buildout-deb.cfg |
|---|
| 84 | |
|---|
| 85 | It is important to use the debian specific buildout configuration |
|---|
| 86 | using the -c switch. This will use the system libraries instead of |
|---|
| 87 | building everything by hand. |
|---|
| 88 | |
|---|
| 89 | Please refer to README.txt for further instructions. They apply to the |
|---|
| 90 | debian buildout with the exception of the buildout invocation given |
|---|
| 91 | above. |
|---|
| 92 | |
|---|
| 93 | |
|---|
