25.3.2.1 Installing NDB Cluster on Windows from a Binary Release — MySQL 9.2

25.3.2.1 Установка NDB Cluster на Windows из двоичного релиза

В этом разделе описывается базовая установка NDB Cluster на Windows с использованием двоичного релиза NDB Cluster «без установки», предоставленного компанией Oracle, с использованием той же конфигурации из четырёх узлов, что и в начале этого раздела (см. Раздел 25.3, «Установка NDB Cluster»), как показано в следующей таблице:

Таблица 25.6 Сетевые адреса узлов в примере кластера

Таблица 25.6 Сетевые адреса узлов в примере кластера
Узел	IP-адрес
Узел управления (mgmd)	198.51.100.10
Узел SQL (mysqld)	198.51.100.20
Узел данных "A" (ndbd)	198.51.100.30
Узел данных "B" (ndbd)	198.51.100.40

Как и на других платформах, на компьютере NDB Cluster, на котором запущен узел SQL, должен быть установлен двоичный файл сервера MySQL (mysqld.exe). Вам также понадобится MySQL-клиент (mysql.exe) на этом узле. Для узлов управления и узлов данных установка двоичного файла сервера MySQL не требуется; однако каждый узел управления требует демона сервера управления (ndb_mgmd.exe); каждый узел данных требует демона узла данных (ndbd.exe или ndbmtd.exe). В этом примере мы будем использовать ndbd.exe как исполняемый файл узла данных, но вы можете установить ndbmtd.exe, многопоточную версию этой программы, точно так же. Вам также следует установить клиент управления (ndb_mgm.exe) на узле сервера управления.

Примечание

Как и в других программах Windows, исполняемые файлы NDB Cluster имеют расширение файла .exe. Однако, при вызове этих программ из командной строки расширение .exe включать не нужно. Поэтому в этой документации мы часто просто ссылаемся на эти программы как на mysqld, mysql, ndb_mgmd и так далее. Вы должны понимать, что, независимо от того, ссылаемся ли мы на mysqld или mysqld.exe, оба названия означают одно и то же (программа сервера MySQL).

Для настройки NDB Cluster с использованием двоичных файлов Oracle no-install, первым шагом процесса установки является загрузка последнего двоичного архива ZIP NDB Cluster для Windows с сайта https://dev.mysql.com/downloads/cluster/. Этот архив имеет имя файла mysql-cluster-gpl-ver-winarch.zip, где ver — версия хранилища NDB (например, 9.2.0), а arch — архитектура (32 для 32-битных двоичных файлов и 64 для 64-битных двоичных файлов). Например, архив NDB Cluster 9.2.0 для 64-битных систем Windows называется mysql-cluster-gpl-9.2.0-win64.zip.

Вы можете запускать 32-битные двоичные файлы NDB Cluster как на 32-битных, так и на 64-битных версиях Windows; однако 64-битные двоичные файлы NDB Cluster могут использоваться только на 64-битных версиях Windows. Если вы используете 32-битную версию Windows на компьютере с 64-битным процессором, вам необходимо использовать 32-битные двоичные файлы NDB Cluster.

Чтобы уменьшить количество файлов, которые необходимо загрузить из Интернета или скопировать между компьютерами, мы начнём с компьютера, на котором планируется запустить узел SQL.

Узел SQL. Предполагается, что вы поместили копию архива в каталог C:\Documents and Settings\username\My Documents\Downloads на компьютере с IP-адресом 198.51.100.20, где username — имя текущего пользователя. (Вы можете получить это имя, используя ECHO %USERNAME% в командной строке.) Для установки и запуска исполняемых файлов NDB Cluster в качестве служб Windows этому пользователю следует быть членом группы Administrators.

Извлеките все файлы из архива. Для этой задачи подходит Мастер извлечения, интегрированный в проводник Windows. (Если вы используете другую программу для архивов, убедитесь, что она извлекает все файлы и каталоги из архива и сохраняет структуру каталогов архива.) Когда вас попросят указать каталог назначения, введите C:\, что заставит Мастер извлечения извлечь архив в каталог C:\mysql-cluster-gpl-ver-winarch. Переименуйте этот каталог в C:\mysql.

Возможно установить двоичные файлы NDB Cluster в каталоги, отличные от C:\mysql\bin; однако, если вы это сделаете, вам необходимо соответствующим образом изменить пути, показанные в данной процедуре. В частности, если двоичный файл сервера MySQL (узел SQL) установлен в местоположение, отличное от C:\mysql или C:\Program Files\MySQL\MySQL Server 9.2, или если каталог данных узла SQL находится в месте, отличном от C:\mysql\data или C:\Program Files\MySQL\MySQL Server 9.2\data, необходимо использовать дополнительные параметры конфигурации в командной строке или добавить их в файл my.ini или my.cnf при запуске узла SQL. Дополнительную информацию о настройке сервера MySQL для работы в нестандартном расположении см. в Разделе 2.3.3, «Конфигурация: вручную».

Чтобы сервер MySQL с поддержкой NDB Cluster работал как часть NDB Cluster, необходимо запустить его с параметрами --ndbcluster и --ndb-connectstring. Хотя вы можете указать эти параметры в командной строке, обычно удобнее разместить их в файле параметров. Для этого создайте новый текстовый файл в Блокноте или другом текстовом редакторе. Введите следующую конфигурационную информацию в этот файл:

[mysqld]
# Options for mysqld process:
ndbcluster                       # run NDB storage engine
ndb-connectstring=198.51.100.10  # location of management server

Вы можете добавить другие параметры, используемые этим сервером MySQL (см. Раздел 2.3.3.2, «Создание файла параметров»), но файл по меньшей мере должен содержать указанные параметры. Сохраните этот файл как C:\mysql\my.ini. Это завершает установку и настройку для узла SQL.

Узлы данных. Узлу данных NDB Cluster на узле Windows требуется только один исполняемый файл — один из ndbd.exe или ndbmtd.exe. В этом примере мы будем использовать ndbd.exe, но те же инструкции применимы и при использовании ndbmtd.exe. На каждом компьютере, на котором вы хотите запустить узел данных (компьютеры с IP-адресами 198.51.100.30 и 198.51.100.40), создайте каталоги C:\mysql, C:\mysql\bin и C:\mysql\cluster-data; затем на компьютере, где вы скачали и извлекли архив no-install, найдите файл ndbd.exe в каталоге C:\mysql\bin. Скопируйте этот файл в каталог C:\mysql\bin на каждом из двух узлов данных.

Для работы в рамках NDB Cluster каждый узел данных должен получить адрес или имя хоста сервера управления. Вы можете предоставить эту информацию в командной строке, используя параметр --ndb-connectstring или -c при запуске каждого процесса узла данных. Однако обычно предпочтительнее поместить эту информацию в файл параметров. Для этого создайте новый текстовый файл в Блокноте или другом текстовом редакторе и введите следующий текст:

[mysql_cluster]
# Options for data node process:
ndb-connectstring=198.51.100.10  # location of management server

Сохраните этот файл как C:\mysql\my.ini на хосте узла данных. Создайте другой текстовый файл с той же информацией и сохраните его как C:mysql\my.ini на хосте другого узла данных или скопируйте файл my.ini с первого хоста узла данных на второй, убедившись, что копия находится в каталоге C:\mysql второго узла данных. Теперь оба хоста узлов данных готовы к использованию в кластере NDB, что оставляет только установку и настройку узла управления.

Узел управления. Единственная исполняемая программа, необходимая на компьютере, используемом для размещения узла управления кластером NDB, — это программа сервера управления ndb_mgmd.exe. Однако для администрирования кластера NDB после его запуска также необходимо установить программу-клиента управления кластером NDB ndb_mgm.exe на том же компьютере, что и сервер управления. Найдите эти две программы на компьютере, где вы скачали и извлекли архив no-install; это должен быть каталог C:\mysql\bin на хосте узла SQL. Создайте каталог C:\mysql\bin на компьютере с IP-адресом 198.51.100.10, затем скопируйте обе программы в этот каталог.

Теперь вы должны создать два файла конфигурации для использования ndb_mgmd.exe:

Файл локальной конфигурации для предоставления данных конфигурации, специфичных для узла управления. Как правило, этот файл должен содержать только расположение глобального файла конфигурации кластера NDB (см. пункт 2).

Чтобы создать этот файл, откройте новый текстовый файл в Блокноте или другом текстовом редакторе и введите следующую информацию:
```
[mysql_cluster]
# Options for management node process
config-file=C:/mysql/bin/config.ini
```
Сохраните этот файл как текстовый файл C:\mysql\bin\my.ini.
Глобальный файл конфигурации, из которого узел управления может получать информацию о конфигурации всего кластера NDB. Как минимум, этот файл должен содержать раздел для каждого узла в кластере NDB и IP-адреса или имена хостов для узла управления и всех узлов данных (параметр конфигурации HostName). Также рекомендуется включить следующую дополнительную информацию:
- IP-адрес или имя хоста любого узла SQL
- Память данных и память индексов, выделенные каждому узлу данных (DataMemory и IndexMemory параметры конфигурации)
- Количество реплик фрагментов, используя параметр конфигурации NoOfReplicas (см. Раздел 25.2.2, «Узлы кластера NDB, группы узлов, реплики фрагментов и разделы»)
- Каталог, в котором каждый узел данных хранит свои данные и файлы журнала, а также каталог, в котором узел управления хранит свои файлы журнала (в обоих случаях, параметр конфигурации DataDir)
Создайте новый текстовый файл с помощью текстового редактора, например Блокнота, и введите следующую информацию:
```
[ndbd default]
# Options affecting ndbd processes on all data nodes:
NoOfReplicas=2                      # Number of fragment replicas
DataDir=C:/mysql/cluster-data       # Directory for each data node's data files
                                    # Forward slashes used in directory path,
                                    # rather than backslashes. This is correct;
                                    # see Important note in text
DataMemory=80M    # Memory allocated to data storage
IndexMemory=18M   # Memory allocated to index storage
                  # For DataMemory and IndexMemory, we have used the
                  # default values. Since the "world" database takes up
                  # only about 500KB, this should be more than enough for
                  # this example Cluster setup.

[ndb_mgmd]
# Management process options:
HostName=198.51.100.10              # Hostname or IP address of management node
DataDir=C:/mysql/bin/cluster-logs   # Directory for management node log files

[ndbd]
# Options for data node "A":
                                # (one [ndbd] section per data node)
HostName=198.51.100.30          # Hostname or IP address

[ndbd]
# Options for data node "B":
HostName=198.51.100.40          # Hostname or IP address

[mysqld]
# SQL node options:
HostName=198.51.100.20          # Hostname or IP address
```
Сохраните этот файл как текстовый файл C:\mysql\bin\config.ini.

Важно

Один символ обратного слэша (\) не может использоваться при указании путей к каталогам в параметрах программ или файлах конфигурации, используемых кластером NDB в Windows. Вместо этого вы должны либо экранировать каждый символ обратного слэша вторым обратным слэшем (\\), либо заменить обратный слэш на прямой слэш (/). Например, следующая строка из раздела [ndb_mgmd] файла конфигурации кластера NDB config.ini не работает:

DataDir=C:\mysql\bin\cluster-logs

Вместо этого вы можете использовать любой из следующих вариантов:

DataDir=C:\\mysql\\bin\\cluster-logs  # Escaped backslashes

DataDir=C:/mysql/bin/cluster-logs     # Forward slashes

Из соображений краткости и удобочитаемости рекомендуется использовать прямые слэши в путях к каталогам, используемых в параметрах программ и файлах конфигурации кластера NDB в Windows.