Установка 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

$ python -m pip install psycopg2

MacPorts¶

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

Резюме:

$ sudo port install postgresql13-server
$ sudo port install geos
$ sudo port install proj6
$ sudo port install postgis3
$ sudo port install gdal
$ sudo port install libgeoip

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

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

Python¶

Установите 64-битную версию Python. Дополнительную информацию см. в разделе Install Python.

PostgreSQL¶

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

Когда программа установки завершится, она спросит «Запустить Stack Builder при выходе?». – проверьте это, так как это необходимо для установки ПостГИС.

ПостГИС¶

В программе Stack Builder (для запуска вне программы установки Start ‣ PostgreSQL 12 ‣ Application Stack Builder) выберите PostgreSQL 12 (x64) on port 5432 из выпадающего меню и нажмите кнопку next. Разверните дерево меню Categories ‣ Spatial Extensions и выберите PostGIS X.Y for PostgreSQL 12.

После нажатия кнопки next вам будет предложено подтвердить выбранный пакет и «Download directory». Нажмите кнопку next еще раз, это приведет к загрузке PostGIS, и вам будет предложено нажать кнопку next для начала работы программы установки PostGIS. Выберите опции по умолчанию во время установки. Процесс установки включает три диалоговых окна «Да/Нет», опция по умолчанию для всех трех - «Нет».

OSGeo4W¶

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

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

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

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%"

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

install Django в вашей системе. Рекомендуется создавать virtual environment для каждого создаваемого проекта.

psycopg2¶

Модуль psycopg2 Python обеспечивает интерфейс между Python и базой данных PostgreSQL. psycopg2 может быть установлен через pip в виртуальной среде Python:

...\> py -m pip install psycopg2

Сноски