Installation de GeoDjangoLien vers cette rubrique#

Variable d’environnement LD_LIBRARY_PATHLien vers cette rubrique#

Un utilisateur peut définir cette variable d’environnement pour personnaliser les chemins de bibliothèques qu’ils souhaitent utiliser. Le répertoire de bibliothèques traditionnel pour du logiciel compilé depuis les sources est /usr/local/lib. Il faut donc inclure /usr/local/lib dans la variable LD_LIBRARY_PATH. Par exemple, voici ce qu’un utilisateur pourrait ajouter dans son fichier de profil bash :

export LD_LIBRARY_PATH=/usr/local/lib

Définition du chemin de bibliothèque au niveau systèmeLien vers cette rubrique#

Sur les systèmes GNU/Linux, il existe le plus souvent un fichier /etc/ld.so.conf qui peut contenir des chemins supplémentaires provenant de fichiers d’un autre répertoire, tel que /etc/ld.so.conf.d. En tant qu’utilisateur root, ajoutez le chemin de bibliothèque personnalisé (comme /usr/local/lib) sur une nouvelle ligne dans ld.so.conf. Ceci est un exemple de la façon dont on peut le faire :

$ sudo echo /usr/local/lib >> /etc/ld.so.conf
$ sudo ldconfig

Pour les utilisateurs d’OpenSolaris, le chemin des bibliothèques systèmes peut être modifié par l’utilitaire crle. Exécutez crle sans option pour afficher la configuration actuelle et exécutez crle -l pour définir un nouveau chemin de bibliothèque. Soyez très prudent lors de la modification de chemins de bibliothèques systèmes :

# crle -l $OLD_PATH:/usr/local/lib

Installation de binutilsLien vers cette rubrique#

GeoDjango utilise la fonction find_library (provenant du module Python ctypes.util) pour chercher les bibliothèques. La routine find_library utilise un programme nommé objdump (faisant partie du paquet binutils) pour vérifier la présence d’une bibliothèque partagée sur les systèmes GNU/Linux. De ce fait, si binutils n’est pas installé sur votre système Linux, le module ctypes de Python pourrait ne pas trouver une bibliothèque même si le chemin des bibliothèques est correctement défini et que les bibliothèques géospatiales ont été compilées avec succès.

Le paquet binutils peut être installé sur les systèmes Debian et Ubuntu en utilisant la commande suivante :

$ sudo apt-get install binutils

De même, sur les systèmes Red Hat et CentOS :

$ sudo yum install binutils

PythonLien vers cette rubrique#

Même si Python est préinstallé sur macOS, il est possible de le réinstaller avec des paquets fournis par la fondation Python Software. Un des avantages de ces installeurs est que la version Python propre à macOS et utilisée en interne par le système d’exploitation n’est pas touchée.

Postgres.appLien vers cette rubrique#

Postgres.app est un serveur PostgreSQL indépendant qui inclut l’extension PostGIS. Il sera aussi nécessaire d’installer gdal et libgeoip avec Homebrew.

Après avoir installé Postgres.app, ajoutez ce qui suit à votre fichier .bash_profile afin de pouvoir exécuter les programmes correspondants à partir de la ligne de commande. Remplacez X.Y par la version de PostgreSQL dans le paquet Postgres.app que vous avez installé :

export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/X.Y/bin

Vous pouvez vérifier si le chemin est correctement défini en tapant which psql dans une invite de commande.

HomebrewLien vers cette rubrique#

Homebrew met à disposition des « recettes » pour la compilation de binaires et de paquets à partir des sources. Il fournit des recettes pour les prérequis de GeoDjango sur les ordinateurs Macintosh tournant sous macOS. Dans la mesure où Homebrew compile les logiciels à partir de leurs sources, Xcode est indispensable.

En résumé :

$ brew install postgresql
$ brew install postgis
$ brew install gdal
$ brew install libgeoip

Paquets KyngChaosLien vers cette rubrique#

William Kyngesburye fournit un certain nombre de paquets binaires de bibliothèques géospatiales qui aident à l’installation de GeoDjango sur macOS sans devoir les compiler à partir des sources. Cependant, Xcode est toujours nécessaire afin de pouvoir compiler les adaptateurs de base de données Python psycopg2 (pour PostGIS).

Téléchargez les paquets des infrastructures suivantes :

• UnixImageIO

• PROJ

• GEOS

• SQLite3 (y compris la bibliothèque SpatiaLite)

• GDAL

Installez les paquets dans l’ordre présenté ci-dessus, car les paquets GDAL et SQLite ont besoin des paquets qui les précèdent dans la liste.

Après cela, vous pouvez aussi installer les paquets binaires KyngChaos pour PostgreSQL et PostGIS.

Après avoir installé les paquets binaires, il faut encore ajouter ce qui suit à votre fichier .profile afin de pouvoir exécuter les programmes correspondants à partir de la ligne de commande :

export PATH=/Library/Frameworks/UnixImageIO.framework/Programs:$PATH
export PATH=/Library/Frameworks/PROJ.framework/Programs:$PATH
export PATH=/Library/Frameworks/GEOS.framework/Programs:$PATH
export PATH=/Library/Frameworks/SQLite3.framework/Programs:$PATH
export PATH=/Library/Frameworks/GDAL.framework/Programs:$PATH
export PATH=/usr/local/pgsql/bin:$PATH

$ python -m pip install psycopg2

MacPortsLien vers cette rubrique#

MacPorts peut être utilisé pour installer les prérequis de GeoDjango sur les ordinateurs tournant sous macOS. Dans la mesure où MacPorts compile les logiciels à partir de leurs sources, Xcode est indispensable.

En résumé :

$ sudo port install postgresql93-server
$ sudo port install geos
$ sudo port install proj
$ sudo port install postgis
$ sudo port install gdal +geos
$ sudo port install libgeoip

PythonLien vers cette rubrique#

Installez une version 64 bits de Python. Voir Installation de Python pour plus d’informations.

PostgreSQLLien vers cette rubrique#

Téléchargez la dernière version de l”installeur PostgreSQL 12.x à partir du site Web EnterpriseDB. Puis, lancez cet installeur, suivez les instructions qui apparaissent et conservez les options par défaut, sauf si vous connaissez les conséquences de leur modification.

Lorsque l’installeur a terminé, il demande de lancer Stack Builder en quittant. Laissez cette option cochée, car c’est nécessaire pour installer PostGIS.

PostGISLien vers cette rubrique#

À partir du programme Stack Builder (à lancer en dehors de l’installeur, Démarrer ‣ PostgreSQL 12 ‣ Application Stack Builder), choisissez PostgreSQL 12 (x64) on port 5432 dans le menu déroulant et cliquez sur Suivant. Ouvrez l’arborescence de menu Categories ‣ Spatial Extensions et choisissez PostGIS X.Y for PostgreSQL 12.

Après avoir cliqué sur suivant, vous devez confirmer le paquet sélectionné et le « Download directory ». Cliquez une nouvelle fois sur suivant, PostGIS sera téléchargé et vous devrez encore cliquer sur suivant pour lancer l’installeur PostGIS. Choisissez les options par défaut lors de l’installation. Le processus d’installation contient trois boîtes de dialogue Oui/Non, l’option par défaut étant Non pour les trois.

OSGeo4WLien vers cette rubrique#

L”installeur OSGeo4W aide à l’installation des bibliothèques PROJ, GDAL et GEOS requises par GeoDjango. Commencez par télécharger l”`installeur OSGeo4W`_ (64bit) et exécutez-le. Choisissez Express Web-GIS Install et cliquez sur suivant. Dans la liste de sélection des paquets, contrôlez que GDAL est sélectionné ; MapServer est aussi sélectionné par défaut, mais n’est pas nécessaire pour GeoDjango et peut être désélectionné sans problème. Après avoir cliqué sur suivant et accepté l’accord de licence, les paquets sont automatiquement téléchargés et installés ; vous pouvez ensuite quitter l’installeur.

Modification de l’environnement WindowsLien vers cette rubrique#

Afin de pouvoir utiliser GeoDjango, il est nécessaire d’ajouter les répertoires OSGeo4W au chemin Path du système Windows. Il faut également créer les variables d’environnement GDAL_DATA et PROJ_LIB. Les commandes ci-après, exécutables avec cmd.exe configurent tout cela. Redémarrez votre appareil une fois que tout est terminé afin que les nouvelles variables d’environnement soient reconnues :

set OSGEO4W_ROOT=C:\OSGeo4W64
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%OSGEO4W_ROOT%\bin
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v Path /t REG_EXPAND_SZ /f /d "%PATH%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v GDAL_DATA /t REG_EXPAND_SZ /f /d "%GDAL_DATA%"
reg ADD "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v PROJ_LIB /t REG_EXPAND_SZ /f /d "%PROJ_LIB%"

Installation de Django et configuration de base de donnéesLien vers cette rubrique#

installez Django sur votre système. Il est recommandé de créer un environnement virtuel pour chaque projet que vous créez.

psycopg2Lien vers cette rubrique#

Le module Python psycopg2 fournit l’interface entre Python et la base de données PostgreSQL. psycopg2 peut être installé par pip dans votre environnement virtuel Python

...\> py -m pip install psycopg2

Notes de bas de page