Установка GeoDjango¶

LD_LIBRARY_PATH переменная среды¶

Пользователь может установить эту переменную окружения, чтобы настроить пути к библиотекам, которые он хочет использовать. Типичным каталогом библиотек для программ, собранных из исходных текстов, является /usr/local/lib. Таким образом, /usr/local/lib должно быть включено в переменную LD_LIBRARY_PATH. Например, пользователь может поместить в свой профиль bash следующее:

export LD_LIBRARY_PATH=/usr/local/lib

Установка пути к системной библиотеке¶

В системах GNU/Linux обычно есть файл в каталоге /etc/ld.so.conf, который может включать дополнительные пути от файлов в другом каталоге, например /etc/ld.so.conf.d. Как пользователь root, добавьте путь к пользовательской библиотеке (например, /usr/local/lib) на новой строке в ld.so.conf. Вот один пример того, как это сделать:

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

Для пользователей OpenSolaris путь к системным библиотекам можно изменить с помощью утилиты crle. Запустите crle без опций, чтобы увидеть текущую конфигурацию, и используйте crle -l для установки нового пути к библиотеке. Будьте очень осторожны при изменении пути к системной библиотеке:

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

Установить binutils¶

GeoDjango использует функцию find_library (из модуля ctypes.util Python) для обнаружения библиотек. Процедура find_library использует программу под названием objdump (часть пакета binutils) для проверки общей библиотеки в системах GNU/Linux. Таким образом, если binutils не установлен на вашей системе Linux, то ctypes Python может не найти вашу библиотеку, даже если путь к библиотеке установлен правильно и геопространственные библиотеки были собраны идеально.

Пакет binutils может быть установлен на системах Debian и Ubuntu с помощью следующей команды:

$ sudo apt-get install binutils

Аналогично, в системах Red Hat и CentOS:

$ sudo yum install binutils

Python¶

Хотя macOS поставляется с установленным Python, пользователи могут использовать программу framework installers, предоставляемую Python Software Foundation. Преимущество использования программы установки заключается в том, что Python в macOS останется «нетронутым» для внутреннего использования в операционной системе.

export PATH=/Library/Frameworks/Python.framework/Versions/Current/bin:$PATH

Postgres.app¶

Postgres.app - это отдельный сервер PostgreSQL, включающий расширение PostGIS. Вам также потребуется установить gdal и libgeoip с Homebrew.

После установки Postgres.app добавьте следующее в .bash_profile, чтобы вы могли запускать программы пакета из командной строки. Замените X.Y на версию PostgreSQL в установленном вами Postgres.app:

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

Вы можете проверить, правильно ли установлен путь, набрав which psql в приглашении терминала.

Homebrew¶

Homebrew предоставляет «рецепты» для сборки двоичных файлов и пакетов из исходных текстов. Он предоставляет рецепты для необходимых условий GeoDjango на компьютерах Macintosh под управлением macOS. Поскольку Homebrew по-прежнему собирает программное обеспечение из исходных текстов, требуется Xcode.

Резюме:

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

Пакеты KyngChaos¶

William Kyngesburye предоставляет ряд geospatial library binary packages, которые упрощают установку GeoDjango на macOS без компиляции из исходников. Однако, Xcode все еще необходим для компиляции адаптеров базы данных Python psycopg2 (для PostGIS).

Загрузите пакеты фреймворка для:

• UnixImageIO
• ПРОЕКТ
• GEOS
• SQLite3 (включает библиотеку SpatiaLite)
• GDAL

Установите пакеты в порядке их перечисления, так как пакеты GDAL и SQLite требуют пакетов, перечисленных перед ними.

После этого вы также можете установить бинарные пакеты KyngChaos для PostgreSQL and PostGIS.

После установки бинарных пакетов вам нужно будет добавить следующее в .profile, чтобы иметь возможность запускать программы пакетов из командной строки:

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

$ pip install psycopg2

MacPorts¶

MacPorts можно использовать для установки предварительных условий GeoDjango на компьютерах под управлением macOS. Поскольку MacPorts по-прежнему собирает программное обеспечение из исходных текстов, требуется Xcode.

Резюме:

$ 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

export PATH=/opt/local/bin:/opt/local/lib/postgresql93/bin

export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/opt/local/lib/postgresql93

Python¶

Install Python.

PostgreSQL¶

Сначала загрузите последнюю версию PostgreSQL 9.x installer с сайта EnterpriseDB. После загрузки просто запустите программу установки, следуйте указаниям на экране и сохраните параметры по умолчанию, если не знаете последствий их изменения.

Когда программа установки завершится, она попросит запустить Application Stack Builder (ASB) при выходе - проверьте это, так как это необходимо для установки ПостГИС.

ПостГИС¶

В конструкторе стека приложений (для запуска вне программы установки Start ‣ Programs ‣ PostgreSQL 9.x) выберите PostgreSQL Database Server 9.x on port 5432 из выпадающего меню. Затем разверните дерево меню Categories ‣ Spatial Extensions и выберите PostGIS X.Y for PostgreSQL 9.x.

После нажатия кнопки next вам будет предложено выбрать зеркало, PostGIS будет загружен, и начнется программа установки PostGIS. Во время установки выбирайте только опции по умолчанию (например, не снимайте флажок с опции создания базы данных PostGIS по умолчанию).

psycopg2¶

Модуль psycopg2 Python обеспечивает интерфейс между Python и базой данных PostgreSQL. Скачайте последнюю версию Windows installer для вашей версии Python и PostgreSQL и запустите, используя настройки по умолчанию. [2]

OSGeo4W¶

OSGeo4W installer упрощает установку библиотек PROJ.4, GDAL и GEOS, необходимых для GeoDjango. Сначала скачайте OSGeo4W installer и запустите его. Выберите Express Web-GIS Install и нажмите кнопку next. В списке „Select Packages“ убедитесь, что выбран GDAL; MapServer и Apache также включены по умолчанию, но они не требуются GeoDjango и могут быть сняты. После нажатия кнопки next пакеты будут автоматически загружены и установлены, после чего вы можете выйти из программы установки.

Изменение среды Windows¶

Для использования GeoDjango вам необходимо добавить каталоги Python и OSGeo4W в систему Windows Path, а также создать переменные окружения GDAL_DATA и PROJ_LIB. Это можно сделать с помощью следующего набора команд, выполняемых с помощью cmd.exe:

set OSGEO4W_ROOT=C:\OSGeo4W
set PYTHON_ROOT=C:\Python3X
set GDAL_DATA=%OSGEO4W_ROOT%\share\gdal
set PROJ_LIB=%OSGEO4W_ROOT%\share\proj
set PATH=%PATH%;%PYTHON_ROOT%;%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%"

Установите Django и настройте базу данных¶

Наконец, install Django в вашей системе.

Сноски