Установка 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 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 on your system. It is recommended that you create a virtual environment for each project you create.

psycopg¶

The psycopg Python module provides the interface between Python and the PostgreSQL database. psycopg can be installed via pip within your Python virtual environment:

...\> py -m pip install psycopg

Сноски