15.4. Процедура установки

Разместить все файлы внутри каталога ПРЕФИКС, а не в /usr/local/pgsql. Собственно файлы будут установлены в различные подкаталоги этого каталога; в самом каталоге ПРЕФИКС никакие файлы не размещаются.

Если у вас есть особые требования, вы также можете изменить отдельные подкаталоги, определив следующие параметры. Однако, если вы оставите для них значения по умолчанию, инсталляция будет перемещаемой, то есть вы сможете переместить каталог после установки. (Это не распространяется на каталоги man и doc.)

Для перемещаемых инсталляций можно передать configure указание --disable-rpath. Кроме того, вы должны будете сказать операционной системе, как найти разделяемые библиотеки.

Вы можете установить архитектурно-зависимые файлы в размещение с другим префиксом, ИСП-ПРЕФИКС, отличным от ПРЕФИКС. Это бывает полезно для совместного использования таких файлов несколькими системами. По умолчанию ИСП-ПРЕФИКС считается равным ПРЕФИКС и все файлы, архитектурно-зависимые и независимые, устанавливаются в одно дерево каталогов, что вам скорее всего и нужно.

Задаёт каталог для исполняемых двоичных программ. По умолчанию это ИСП-ПРЕФИКС/bin, что обычно означает /usr/local/pgsql/bin.

Задаёт каталог для различных файлов конфигурации, ПРЕФИКС/etc по умолчанию.

Задаёт каталог для установки библиотек и динамически загружаемых модулей. Значение по умолчанию — ИСП-ПРЕФИКС/lib.

Задаёт каталог для установки заголовочных файлов C и C++. Значение по умолчанию — ПРЕФИКС/include.

Задаёт корневой каталог для разного рода статических файлов. Этот параметр определяет только базу для некоторых из следующих параметров. Значение по умолчанию — ПРЕФИКС/share.

Задаёт каталог для статических файлов данных, используемых установленными программами. Значение по умолчанию — DATAROOTDIR. Заметьте, что это совсем не тот каталог, в котором будут размещены файлы базы данных.

Задаёт каталог для установки данных локализации, в частности, каталогов перевода сообщений. Значение по умолчанию — DATAROOTDIR/locale.

Страницы man, поставляемые в составе PostgreSQL, будут установлены в этот каталог, в соответствующие подкаталоги manx. Значение по умолчанию — DATAROOTDIR/man.

Задаёт корневой каталог для установки файлов документации, кроме страниц "man". Этот параметр только определяет базу для следующих параметров. Значение по умолчанию — DATAROOTDIR/doc/postgresql.

В этот каталог будет помещена документация PostgreSQL в формате HTML. Значение по умолчанию — DATAROOTDIR.

Заданная СТРОКА добавляется к номеру версии PostgreSQL. Это можно использовать, например, чтобы двоичные файлы, собранные из промежуточных снимков Git или кода с дополнительными правками, отличались от стандартных дополнительной строкой в версии, например, содержащей идентификатор git describe или номер выпуска дистрибутивного пакета.

Значение КАТАЛОГИ представляет список каталогов через двоеточие, которые будут просмотрены компилятором при поиске заголовочных файлов. Если дополнительные пакеты (например, GNU Readline) установлены у вас в нестандартное расположение, вам придётся использовать этот параметр и, возможно, также добавить соответствующий параметр --with-libraries.

Пример: --with-includes=/opt/gnu/include:/usr/sup/include.

Значение КАТАЛОГИ представляет список каталогов через двоеточие, в котором следует искать библиотеки. Возможно, вам потребуется использовать этот параметр (и соответствующий --with-includes), если какие-то пакеты установлены у вас в нестандартное размещение.

Пример: --with-libraries=/opt/gnu/lib:/usr/sup/lib.

Включает поддержку национальных языков (NLS, Native Language Support), то есть возможность выводить сообщения программы не только на английском языке. Значение ЯЗЫКИ представляет необязательный список кодов языков через пробел, поддержка которых вам нужна, например: --enable-nls='de fr ru'. (Пересечение заданного вами списка и множества действительно доступных переводов будет вычислено автоматически.) Если список не задаётся, устанавливаются все доступные переводы.

Для использования этой возможности вам потребуется реализация API Gettext; см. выше.

Задаёт НОМЕР порта по умолчанию для сервера и клиентов. Стандартное значение — 5432. Этот порт всегда можно изменить позже, но если вы укажете другой номер здесь, и сервер, и клиенты будут скомпилированы с одним значением, что очень удобно. Обычно менять это значение имеет смысл, только если вы намерены запускать в одной системе несколько серверов PostgreSQL.

Включает поддержку языка PL/Perl на стороне сервера.

Включает поддержку языка PL/Python на стороне сервера.

Включает поддержку языка PL/Tcl на стороне сервера.

Tcl устанавливает файл tclConfig.sh, содержащий конфигурационные данные, необходимые для сборки модулей, взаимодействующих с Tcl. Этот файл обычно находится автоматически в известном размещении, но если вы хотите использовать другую версию Tcl, вы должны указать каталог, где искать этот файл.

Включает поддержку аутентификации GSSAPI. На многих платформах подсистема GSSAPI (обычно входящая в состав Kerberos) устанавливается не в то размещение, которое просматривается по умолчанию (например, /usr/include, /usr/lib), так что помимо этого параметра вам придётся задать параметры --with-includes и --with-libraries. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции GSSAPI, прежде чем продолжить.

Задаёт имя по умолчанию для субъекта-службы Kerberos, используемое GSSAPI (по умолчанию это postgres). Обычно менять его имеет смысл только в среде Windows, где оно должно быть задано в верхнем регистре (POSTGRES).

Включает поддержку соединений SSL (зашифрованных). Для этого необходимо установить пакет OpenSSL. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции OpenSSL, прежде чем продолжить.

Включает поддержку PAM (Pluggable Authentication Modules, подключаемых модулей аутентификации).

Включает поддержку LDAP для проверки подлинности и получения параметров соединения (за дополнительными сведениями обратитесь к Разделу 31.17 и Подразделу 19.3.7). В Unix для этого нужно установить пакет OpenLDAP. В Windows используется стандартная библиотека WinLDAP. Скрипт configure проверит наличие необходимых заголовочных файлов и библиотек, чтобы убедиться в целостности инсталляции OpenLDAP, прежде чем продолжить.

Запрещает использование библиотеки Readline (а также libedit). При этом отключается редактирование командной строки и история в psql, так что этот вариант не рекомендуется.

Отдаёт предпочтение библиотеке libedit с лицензией BSD, а не Readline (GPL). Этот параметр имеет значение, только если установлены обе библиотеки; по умолчанию в этом случае используется Readline.

Включает поддержку Bonjour. Для этого Bonjour должен поддерживаться самой операционной системой. Рекомендуется для OS X.

Собрать модуль uuid-ossp (предоставляющий функции для генерирования UUID), используя заданную библиотеку UUID.БИБЛИОТЕКА может быть следующей:

• bsd, чтобы использовались функции получения UUID, имеющиеся во FreeBSD, NetBSD и некоторых других системах на базе BSD

• e2fs, чтобы использовалась библиотека получения UUID, созданная в рамках проекта e2fsprogs; эта библиотека присутствует в большинстве систем Linux и OS X, также её можно найти и для других платформ.

• ossp, чтобы использовалась библиотека OSSP UUID

Устаревший вариант указания --with-uuid=ossp.

Собрать с libxml (включает поддержку SQL/XML). Для этого требуется libxml версии 2.6.23 или новее.

В составе libxml устанавливается программа xml2-config, с помощью которой можно получить требуемые параметры компилятора и компоновщика. PostgreSQL будет использовать её автоматически, если найдёт. Чтобы указать нестандартное размещение libxml, вы можете воспользоваться переменной окружения XML2_CONFIG и указать в ней путь к программе xml2-config нужной инсталляции, либо задать параметры --with-includes и --with-libraries.

Использовать libxslt при сборке модуля xml2. Библиотека xml2 задействует её для выполнения XSL-преобразований XML.

Отключает применение 64-битных целых для хранения времени и интервалов, чтобы значения даты/времени хранились в виде чисел с плавающей точкой. Числа с плавающей точкой применялись для хранения дат/времени по умолчанию в PostgreSQL до версии 8.4, но сейчас этот вариант считается устаревшим, так как с ним не поддерживается точность до микросекунд во всём диапазоне значений timestamp. Однако для хранения таких значений в целочисленном виде требуется поддержка целочисленного 64-битного типа. Поэтому прежний вариант может использоваться, когда такой тип не поддерживается или для совместимости с приложениями, написанными для предыдущих версий PostgreSQL. За дополнительными сведениями обратитесь к Разделу 8.5.

Запрещает передачу типа float4 "по значению", чтобы он передавался "по ссылке". Это снижает быстродействие, но может быть необходимо для совместимости со старыми пользовательскими функциями на языке C, которые используют соглашение о вызовах "версии 0". В качестве более долгосрочного решения лучше модернизировать такие функции, чтобы они использовали соглашение "версии 1".

Запрещает передачу типа float8 "по значению", чтобы он передавался "по ссылке". Это снижает быстродействие, но может быть необходимо для совместимости со старыми пользовательскими функциями на языке C, которые используют соглашение о вызовах "версии 0". В качестве более долгосрочного решения лучше модернизировать такие функции, чтобы они использовали соглашение "версии 1". Заметьте, что этот параметр влияет не только на float8, но и на int8, а также некоторые другие типы, например timestamp. На 32-битных платформах параметр --disable-float8-byval действует по умолчанию и задать --enable-float8-byval нельзя.

Задаёт размер сегмента (в гигабайтах). Сервер делит большие таблицы на несколько файлов в файловой системе, ограничивая размер каждого данным размером сегмента. Это позволяет обойти ограничения на размер файлов, существующие на многих платформах. Размер сегмента по умолчанию, 1 гигабайт, безопасен для всех поддерживаемых платформ. Если же ваша операционная система поддерживает "большие файлы" (а сегодня это поддерживают почти все), вы можете установить больший размер сегмента. Это позволит уменьшить число файловых дескрипторов, используемых при работе с очень большими таблицами. Но будьте осторожны, чтобы выбранное значение не превысило максимум, поддерживаемый вашей платформой и файловыми системами, которые вы будете применять. Возможно, допустимый размер файла будет ограничиваться и другими утилитами, которые вы захотите использовать, например tar. Рекомендуется, хотя и не требуется, чтобы это значение было степенью 2. Заметьте, что при изменении значения требуется выполнить initdb.

Задаёт размер блока (в килобайтах). Эта величина будет единицей хранения и ввода/вывода данных таблиц. Значение по умолчанию, 8 килобайт, достаточно универсально; но в особых случаях может быть оправдан другой размер блока. Это значение должно быть степенью 2 от 1 до 32 (в килобайтах). Заметьте, что при изменении значения требуется выполнить initdb.

Задаёт размер сегмента WAL (в мегабайтах). Эта величина определяет размер каждого отдельного файла журнала WAL. Изменять этот размер бывает полезно для оптимизации фрагментации при трансляции журналов. Значение по умолчанию — 16 мегабайт. Значение должно задаваться степенью 2 от 1 до 64 (в мегабайтах). Заметьте, что при изменении значения требуется выполнить initdb.

Задаёт размер блока WAL (в килобайтах) Эта величина будет единицей хранения и ввода/вывода записей WAL. Значение по умолчанию, 8 килобайт, достаточно универсально; но в особых случаях может быть оправдан другой размер блока. Это значение должно быть степенью 2 от 1 до 64 (в килобайтах). Заметьте, что при изменении значения требуется выполнить initdb.

Позволяет провести сборку, если PostgreSQL не может воспользоваться циклическими блокировками CPU на данной платформе. Отсутствие таких блокировок приводит к снижению производительности, поэтому использовать этот вариант следует, только если сборка прерывается и выдаётся сообщение, что ваша платформа эти блокировки не поддерживает. Если вы не можете собрать PostgreSQL на вашей платформе без этого указания, сообщите о данной проблеме разработчикам PostgreSQL.

Отключает потокобезопасное поведение клиентских библиотек. При этом параллельные потоки программ на базе libpq и ECPG не будут безопасно контролировать собственные дескрипторы соединений.

В PostgreSQL включена собственная база данных часовых поясов, необходимая для операций с датой и временем. На самом деле эта база данных совместима с базой часовых поясов IANA, поставляемой в составе многих операционных систем FreeBSD, Linux, Solaris, поэтому устанавливать её дополнительно может быть излишне. С этим параметром вместо базы данных, включённой в пакет исходного кода PostgreSQL, будет использоваться системная база данных часовых поясов, находящаяся в заданном КАТАЛОГЕ. КАТАЛОГ должен задаваться абсолютным путём (в ряде операционных систем принят путь /usr/share/zoneinfo). Заметьте, что процедура установки не будет проверять несоответствия или ошибки в данных часовых поясов. Поэтому, используя этот параметр, рекомендуется выполнить регрессионные тесты, чтобы убедиться, что выбранная вами база данных часовых поясов работает корректно с PostgreSQL.

Этот параметр в основном предназначен для тех, кто собирает двоичные пакеты для дистрибутивов и хорошо знает свою операционную систему. Основной плюс от использования системных данных в том, что пакет PostgreSQL не придётся обновлять при изменениях местных определений часовых поясов. Ещё один плюс заключается в упрощении кросс-компиляции, так как при инсталляции не требуется собирать базу данных часовых поясов.

Запрещает использование библиотеки Zlib. При этом отключается поддержка сжатых архивов утилитами pg_dump и pg_restore. Этот параметр предназначен только для тех редких систем, в которых нет этой библиотеки.

Включает компиляцию всех программ и библиотек с отладочными символами. Это значит, что вы сможете запускать программы в отладчике для анализа проблем. При такой компиляции размер установленных исполняемых файлов значительно увеличивается, а компиляторы, кроме GCC, обычно отключают оптимизацию, что снижает быстродействие. Однако, наличие отладочных символов очень полезно при решении возможных проблем любой сложности. В настоящее время рекомендуется использовать этот параметр для производственной среды, только если применяется компилятор GCC. Но если вы занимаетесь разработкой или испытываете бета-версию, его следует использовать всегда.

При использовании GCC все программы и библиотеки компилируются с инструментарием, оценивающим покрытие кода тестами. В этом случае в каталоге сборки будут сформированы файлы с метриками покрытия кода. За дополнительными сведениями обратитесь к Разделу 30.5. Этот параметр предназначен только для GCC и только для тех, кто занимается разработкой.

При использовании GCC все программы и библиотеки компилируются так, чтобы их можно было профилировать. В результате по завершении серверного процесса будет создаваться подкаталог с файлом gmon.out для профилирования. Этот параметр предназначен только для GCC и только для тех, кто занимается разработкой.

Включает для сервера проверочные утверждения, проверяющие множество условий, которые "не должны происходить". Это бесценно в процессе разработке кода, но эти проверки могут значительно замедлить работу сервера. Кроме того, включение этих проверок не обязательно увеличит стабильность вашего сервера! Проверочные утверждения не категоризируются по важности, поэтому относительно безвредная ошибка может привести к перезапуску сервера, если утверждение не выполнится. Применять это следует, только если вы занимаетесь разработкой или испытываете бета-версию, но не в производственной среде.

Включает автоматическое отслеживание зависимостей. С этим параметром скрипты Makefile настраиваются так, чтобы при изменении любого заголовочного файла пересобирались все зависимые объектные файлы. Это полезно в процессе разработки, но если вам нужно только скомпилировать и установить сервер, это будет лишней тратой времени. В настоящее время это работает только с GCC.

Включает при компиляции PostgreSQL поддержку средства динамической трассировки DTrace. За дополнительными сведениями обратитесь к Разделу 27.4.

Задать расположение программы dtrace можно в переменной окружения DTRACE. Часто это необходимо, потому что dtrace обычно устанавливается в каталог /usr/sbin, который может отсутствовать в пути поиска.

Дополнительные параметры командной строки для dtrace можно задать в переменной окружения DTRACEFLAGS. В Solaris, чтобы включить поддержку DTrace для 64-битной сборки, необходимо передать configure параметр DTRACEFLAGS="-64". Например, с компилятором GCC:

./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ...

С компилятором Sun:

./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS='-64' ...

Включает тесты по технологии Perl TAP. Для этого у вас должен быть установлен Perl и модуль IPC::Run. За дополнительными сведениями обратитесь к Разделу 30.4.

Программа Bison

компилятор C

параметры, передаваемые компилятору C

препроцессор C

параметры, передаваемые препроцессору C

расположение программы dtrace

параметры, передаваемые программе dtrace

программа Flex

параметры, которые должны использоваться при компоновке исполняемых программ или разделяемых библиотек

дополнительные параметры для компоновки только исполняемых программ

дополнительные параметры для компоновки только разделяемых библиотек

расположение программы msgfmt для поддержки национальных языков

Полный путь к интерпретатору Perl. Он нужен для определения зависимостей при сборке PL/Perl.

Полный путь к интерпретатору Python. Он нужен для определения зависимостей при сборке PL/Python. Кроме того, в зависимости от того, какой Python, 2 или 3, выбран здесь (или неявно как-то ещё), определяется вариация языка PL/Python, которая будет доступна. За дополнительными сведениями обратитесь к Разделу 43.1.

Полный путь к интерпретатору Tcl. Он нужен для определения зависимостей при сборке PL/Tcl и будет подставляться в скрипты Tcl.

Программа xml2-config помогает найти инсталляцию libxml.