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

Установите 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 в вашей системе. Рекомендуется создавать virtural environment для каждого создаваемого проекта.

psycopg2¶

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

...\> py -m pip install psycopg2

Сноски