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

25.3.2.1 Установка NDB Cluster на Windows из двоичного выпуска

В этом разделе описывается базовая установка NDB Cluster на Windows с использованием двоичного выпуска NDB Cluster “без установки”, предоставленного компанией Oracle, используя ту же конфигурацию из 4 узлов, что и в начале этого раздела (см. Раздел 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 Server (mysqld.exe). Также на этом узле должен быть установлен MySQL-клиент (mysql.exe). Для узлов управления и узлов данных не требуется устанавливать двоичный файл MySQL Server; однако каждый узел управления требует демона сервера управления (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 Server).

При настройке NDB Cluster с использованием двоичных файлов Oracle no-install первым шагом процесса установки является загрузка последнего двоичного архива ZIP NDB Cluster Windows с сайта https://dev.mysql.com/downloads/cluster/. В имени этого архива будет mysql-cluster-gpl-ver-winarch.zip, где ver — версия хранилища NDB (например, 8.4.4), а arch — архитектура (32 для 32-битных двоичных файлов и 64 для 64-битных двоичных файлов). Например, архив NDB Cluster 8.4.4 для 64-битных систем Windows называется mysql-cluster-gpl-8.4.4-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 Server (SQL-узел) установлен в расположение, отличное от C:\mysql или C:\Program Files\MySQL\MySQL Server 8.4, или если каталог данных SQL-узла находится в другом расположении, отличном от C:\mysql\data или C:\Program Files\MySQL\MySQL Server 8.4\data, необходимо использовать дополнительные параметры конфигурации в командной строке или добавить их в файл my.ini или my.cnf при запуске SQL-узла. Более подробную информацию о конфигурации MySQL Server для работы в нестандартном расположении см. в Разделе 2.3.3, «Конфигурация: Ручной способ».

Для работы MySQL Server с поддержкой 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 Server (см. Раздел 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.