Spec-Zone.ru › MySQL 9.2

2.8.4 Установка MySQL с использованием стандартного исходного распределения

Для установки MySQL из стандартного исходного распределения:

  1. Убедитесь, что ваша система удовлетворяет требованиям инструментов, перечисленным в разделе 2.8.2, «Предварительные требования к установке из исходных кодов».

  2. Получите файл дистрибутива, используя инструкции в разделе 2.1.3, «Как получить MySQL».

  3. Настройте, скомпилируйте и установите дистрибутив, используя инструкции в этом разделе.

  4. Выполните послеустановочные процедуры, используя инструкции в разделе 2.9, «Настройка и тестирование после установки».

MySQL использует CMake в качестве фреймворка сборки на всех платформах. Приведенные здесь инструкции должны позволить вам выполнить успешную установку. Дополнительную информацию о использовании CMake для сборки MySQL см. в How to Build MySQL Server with CMake.

Если вы начинаете с исходного RPM-пакета, используйте следующую команду для создания двоичного RPM-пакета, который вы можете установить. Если у вас нет rpmbuild, используйте rpm вместо него.

$> rpmbuild --rebuild --clean MySQL-VERSION.src.rpm

В результате получается один или несколько двоичных RPM-пакетов, которые вы устанавливаете, как указано в разделе 2.5.4, «Установка MySQL на Linux с использованием RPM-пакетов от Oracle».

Последовательность установки из сжатого файла tar или Zip-архива исходного дистрибутива аналогична процессу установки из общего двоичного дистрибутива (см. раздел 2.2, «Установка MySQL на Unix/Linux с использованием универсальных двоичных файлов»), за исключением того, что он используется на всех платформах и включает шаги настройки и компиляции дистрибутива. Например, с исходным дистрибутивом в сжатом файле tar на Unix, базовая последовательность команд установки выглядит так:

# Preconfiguration setup
$> groupadd mysql
$> useradd -r -g mysql -s /bin/false mysql
# Beginning of source-build specific instructions
$> tar zxvf mysql-VERSION.tar.gz
$> cd mysql-VERSION
$> mkdir bld
$> cd bld
$> cmake ..
$> make
$> make install
# End of source-build specific instructions
# Postinstallation setup
$> cd /usr/local/mysql
$> mkdir mysql-files
$> chown mysql:mysql mysql-files
$> chmod 750 mysql-files
$> bin/mysqld --initialize --user=mysql
$> bin/mysqld_safe --user=mysql &
# Next command is optional
$> cp support-files/mysql.server /etc/init.d/mysql.server

Более подробная версия инструкций по сборке из исходных кодов показана ниже.

Примечание

В данном процедуре не настраиваются пароли для учетных записей MySQL. После выполнения процедуры перейдите к разделу 2.9, «Настройка и тестирование после установки» для настройки и тестирования после установки.

  • Выполнение предварительной настройки

  • Получение и распаковка дистрибутива

  • Настройка дистрибутива

  • Сборка дистрибутива

  • Установка дистрибутива

  • Выполнение послеустановочной настройки

Выполнение предварительной настройки

В Unix, настройте пользователя mysql, который владеет каталогом базы данных и который должен использоваться для запуска и выполнения сервера MySQL, и группу, к которой принадлежит этот пользователь. Для получения подробной информации см. Создание пользователя и группы mysql. Затем выполните следующие шаги как пользователь mysql, за исключением случаев, указанных отдельно.

Получение и распаковка дистрибутива

Выберите каталог, в который вы хотите распаковать дистрибутив, и перейдите в него.

Получите файл дистрибутива, используя инструкции в разделе 2.1.3, «Как получить MySQL».

Распакуйте дистрибутив в текущий каталог:

  • Для распаковки сжатого файла tar, tar может распаковать дистрибутив, если он поддерживает опцию z:

    $> tar zxvf mysql-VERSION.tar.gz
    

    Если у вашего tar нет поддержки опции z, используйте gunzip для распаковки дистрибутива и tar для его извлечения:

    $> gunzip < mysql-VERSION.tar.gz | tar xvf -
    

    В качестве альтернативы, CMake может распаковать дистрибутив:

    $> cmake -E tar zxvf mysql-VERSION.tar.gz
    
  • Для распаковки Zip-архива используйте WinZip или другой инструмент, который может читать файлы .zip.

Распаковка файла дистрибутива создает каталог с именем mysql-VERSION.

Настройка дистрибутива

Перейдите в корневой каталог распакованного дистрибутива:

$> cd mysql-VERSION

Выполните сборку вне дерева исходного кода, чтобы сохранить чистоту дерева. Если корневой каталог исходного кода называется mysql-src в вашей текущей рабочей директории, вы можете выполнить сборку в директории с именем build на том же уровне. Создайте директорию и перейдите в неё:

$> mkdir bld
$> cd bld

Настройте директорию сборки. Минимальная команда настройки не включает опции для переопределения значений по умолчанию конфигурации:

$> cmake ../mysql-src

Директория сборки необязательно должна находиться вне дерева исходного кода. Например, вы можете выполнить сборку в директории с именем build в корневом каталоге исходного кода. Для этого, начиная с mysql-src как вашей текущей рабочей директории, создайте директорию build и перейдите в неё:

$> mkdir build
$> cd build

Настройте директорию сборки. Минимальная команда настройки не включает опции для переопределения значений по умолчанию конфигурации:

$> cmake ..

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

В Windows укажите среду разработки. Например, следующие команды настраивают MySQL для 32-битной или 64-битной сборки, соответственно:

$> cmake .. -G "Visual Studio 12 2013"

$> cmake .. -G "Visual Studio 12 2013 Win64"

В macOS, для использования IDE Xcode:

$> cmake .. -G Xcode

При запуске Cmake, вы можете добавить опции в командную строку. Вот несколько примеров:

  • -DBUILD_CONFIG=mysql_release: Настройте исходный код с теми же параметрами сборки, которые используются Oracle для создания двоичных дистрибутивов для официальных релизов MySQL.

  • -DCMAKE_INSTALL_PREFIX=dir_name: Настройте дистрибутив для установки в определённом месте.

  • -DCPACK_MONOLITHIC_INSTALL=1: Заставьте make package сгенерировать один установочный файл вместо нескольких.

  • -DWITH_DEBUG=1: Соберите дистрибутив с поддержкой отладки.

Полный список опций см. в разделе 2.8.7, «Параметры конфигурации исходного кода MySQL».

Для вывода списка опций конфигурации используйте одну из следующих команд:

$> cmake .. -L   # overview

$> cmake .. -LH  # overview with help text

$> cmake .. -LAH # all params with help text

$> ccmake ..     # interactive display

Если CMake завершается ошибкой, возможно, необходимо перенастроить его, запустив его снова с другими параметрами. Если вы перенастраиваете, обратите внимание на следующее:

  • Если CMake запускается после предыдущего запуска, он может использовать информацию, полученную во время предыдущего вызова. Эта информация хранится в CMakeCache.txt. При запуске CMake он ищет этот файл и считывает его содержимое, если он существует, предполагая, что информация всё ещё верна. Это предположение неверно при перенастройке.

  • Каждый раз, когда вы запускаете CMake, вы должны повторно запустить make для перекомпиляции. Однако вы можете удалить старые файлы объектов из предыдущих сборок, так как они были скомпилированы с помощью других параметров конфигурации.

Чтобы предотвратить использование старых файлов объектов или информации о конфигурации, выполните эти команды в директории сборки в Unix перед повторным запуском CMake:

$> make clean
$> rm CMakeCache.txt

Или, в Windows:

$> devenv MySQL.sln /clean
$> del CMakeCache.txt

Перед обращением в MySQL Community Slack, проверьте файлы в директории CMakeFiles на наличие полезной информации о причине ошибки. Для отправки отчета об ошибке используйте инструкции в разделе 1.6, «Как сообщать об ошибках или проблемах».

Сборка дистрибутива

В Unix:

$> make
$> make VERBOSE=1

Вторая команда задаёт VERBOSE, чтобы показать команды для каждого скомпилированного источника.

Используйте gmake вместо make на системах, где вы используете GNU make и он был установлен как gmake.

В Windows:

$> devenv MySQL.sln /build RelWithDebInfo

Если вы дошли до этапа компиляции, но дистрибутив не собирается, см. раздел 2.8.8, «Обработка проблем при компиляции MySQL» для получения помощи. Если это не решит проблему, пожалуйста, внесите её в нашу базу ошибок, используя инструкции, указанные в разделе 1.6, «Как сообщать об ошибках или проблемах». Если вы установили самые последние версии необходимых инструментов, и они завершаются сбоем при обработке наших конфигурационных файлов, сообщите об этом тоже. Однако, если вы получите ошибку command not found или похожую проблему с необходимыми инструментами, не сообщайте об этом. Убедитесь, что все необходимые инструменты установлены и что ваша переменная PATH установлена правильно, чтобы ваша оболочка могла их найти.

Установка дистрибутива

В Unix:

$> make install

Это устанавливает файлы в настроенной директории установки (по умолчанию, /usr/local/mysql). Возможно, вам придётся запустить команду от имени администратора (root).

Для установки в определённую директорию добавьте параметр DESTDIR в командную строку:

$> make install DESTDIR="/opt/mysql"

В качестве альтернативы, сгенерируйте файлы установочных пакетов, которые можно установить в нужное вам место:

$> make package

Эта операция создаёт один или несколько файлов .tar.gz, которые можно установить, как пакеты двоичных дистрибутивов общего назначения. См. раздел 2.2, «Установка MySQL на Unix/Linux с использованием общих двоичных файлов». Если вы запустите CMake с -DCPACK_MONOLITHIC_INSTALL=1, операция создаст один файл. В противном случае, она создаст несколько файлов.

В Windows сгенерируйте директорию данных, а затем создайте архивный установочный пакет .zip:

$> devenv MySQL.sln /build RelWithDebInfo /project initial_database
$> devenv MySQL.sln /build RelWithDebInfo /project package

Вы можете установить полученный архив .zip в любое нужное вам место. См. раздел 2.3.3, «Настройка: вручную».

Выполнение пост-установочной настройки

Остальная часть процесса установки включает настройку конфигурационного файла, создание основных баз данных и запуск сервера MySQL. Инструкции см. в разделе 2.9, «Постустановочная настройка и тестирование».

Примечание

Учётные записи, перечисленные в таблицах наград MySQL, первоначально не имеют паролей. После запуска сервера вы должны установить пароли для них, следуя инструкциям в разделе 2.9, «Постустановочная настройка и тестирование».

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-8.4-en/installing-source-distribution.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API