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

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 15.x installer с сайта EnterpriseDB. После загрузки запустите программу установки, следуйте инструкциям на экране и сохраняйте параметры по умолчанию, если не знаете последствий их изменения.

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

ПостГИС¶

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

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

OSGeo4W¶

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

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

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

set OSGEO4W_ROOT=C:\OSGeo4W
set GDAL_DATA=%OSGEO4W_ROOT%\apps\gdal\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 для каждого создаваемого проекта.

psycopg¶

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

...\> py -m pip install psycopg

Сноски