8.11 Upgrade InnoDB ClusterSet — MySQL Shell 8.4

8.11 Модернизация InnoDB ClusterSet

Для модернизации серверных экземпляров в InnoDB ClusterSet выполните следующие шаги:

Проверьте версии установленных библиотек:

mysqlrouter --version: Проверяет версию установленного MySQL Router.
mysqlsh --version: Проверяет версию установленного MySQL Shell.
mysqld --version: Проверяет версию установленного MySQL Server.

Модернизация MySQL Router.

Для модернизации MySQL Router выполните следующие шаги:

Остановите MySQL Router.

В Unix-подобной системе, если вы использовали необязательный --directory параметр bootstrap, создана автономная установка со всеми сгенерированными каталогами и файлами в указанном вами месте при установке маршрутизатора. Эти файлы включают stop.sh. Перейдите в этот каталог и выполните эту команду:
```
./stop.sh
```
В Microsoft Windows, если вы использовали необязательный --directory параметр bootstrap, создана автономная установка со всеми сгенерированными каталогами и файлами в указанном вами месте при установке маршрутизатора. Эти файлы включают stop.ps1. Перейдите в этот каталог и выполните эту команду:
```
.\stop.ps1
```
Или в Linux-системе, использующей systemd, остановите службу MySQL Router, выполнив:
```
systemctl stop mysqlrouter.service
```
В противном случае, завершите процесс (PID) связанного процесса mysqlrouter.
установите последнюю версию MySQL Router.
Запустите MySQL Router.

В Unix-подобной системе, если вы использовали необязательный --directory параметр bootstrap, создана автономная установка со всеми сгенерированными каталогами и файлами в указанном вами месте. Эти файлы включают start.sh. Перейдите в каталог и выполните эту команду:
```
./start.sh
```
Если путь к новому маршрутизатору изменился, необходимо обновить скрипт оболочки start.sh, чтобы он отражал новый путь.
```
#!/bin/bash
basedir=/tmp/myrouter
ROUTER_PID=$basedir/mysqlrouter.pid /usr/bin/mysqlrouter -c $basedir/mysqlrouter.conf &
disown %-
```
Если вы модернизируете MySQL Router вручную, в отличие от использования управления пакетами, вы можете обновить basedir=. Повторная инициализация маршрутизатора также восстанавливает скрипт оболочки start.sh.

Или в Linux-системе, использующей systemd, запустите службу MySQL Router, выполнив:
```
systemctl start mysqlrouter.service
```
В Microsoft Windows, если вы использовали необязательный --directory параметр bootstrap, создана автономная установка со всеми сгенерированными каталогами и файлами в указанном вами месте. Эти файлы включают start.ps1. Перейдите в каталог и выполните эту команду:
```
.\start.ps1
```
При запуске MySQL Router с использованием новых библиотек маршрутизатора, версия маршрутизатора обновляется:
```
mysqlrouter --version
```

Модернизация MySQL Shell

Модернизируйте MySQL Shell, установив новые бинарники, и остановив и запустив MySQL Shell:

Получите и установите последнюю версию MySQL Shell.
Остановите и выйдите из MySQL Shell, выполнив:
```
\q
```
Перезапустите MySQL Shell из командной строки, выполнив:
```
mysqlsh
```
Обновите метаданные InnoDB ClusterSet:
- Для обновления ClusterSet, подключите глобальную сессию MySQL Shell к вашему ClusterSet и используйте операцию dba.upgradeMetadata() для обновления метаданных ClusterSet до новых метаданных.
  
  Если схема метаданных ClusterSet требует обновления, процесс обновления должен выполняться в основном кластере ClusterSet.
  
  Обновление метаданных
  
  Обновление метаданных может ничего не делать, если InnoDB ClusterSet уже использует последнюю версию.

Модернизация MySQL Server

Модернизируйте MySQL Server, сначала модернизировав все экземпляры реплицируемых кластеров, а затем экземпляры основного кластера.

При модернизации каждого кластера, основного или реплицируемого, модернизируйте все вторичные экземпляры перед модернизацией основного экземпляра.

Модернизация MySQL Server необязательна

Модернизация MySQL Server необязательна. Модернизации серверов могут иметь большее влияние, чем модернизация MySQL Shell и MySQL Router. Также, вы всегда должны поддерживать MySQL Shell и MySQL Router в последней версии, даже если сервер не обновлен; это справедливо для InnoDB Clusters и ReplicaSets.

Подробнее об обновлении с использованием Group Replication см. .

Остановите MySQL Server, выполнив одну из следующих команд:
- Если MySQL Server использует systemd, выполните:
```
systemctl stop mysqld
```
- Если MySQL Server использует init.d, выполните:
```
/etc/init.d/mysql stop
```
- Если MySQL Server использует service, выполните:
```
service mysql stop
```
- Если вы развернули MySQL Server в Microsoft Windows, выполните:
```
mysqladmin -u root -p shutdown
```
установите последнюю версию MySQL Server.
Запустите MySQL Server, выполнив одну из следующих команд:
- Если MySQL Server использует systemd, выполните:
```
systemctl start mysqld
```
- Если MySQL Server использует init.d, выполните:
```
/etc/init.d/mysql start
```
- Если MySQL Server использует service, выполните:
```
service mysql start
```
- Если вы развернули MySQL Server в Microsoft Windows, выполните:
```
mysqld
```
После модернизации всех вторичных экземпляров, модернизируйте основной экземпляр для завершения процесса модернизации.

Проверка состояния после обновления

После обновления MySQL Router, MySQL Shell и MySQL Server:

Проверьте состояние ClusterSet, выполнив команду <ClusterSet>.status(). Дополнительную информацию о <ClusterSet>.status() см. в разделе 8.7 «Статус и топология InnoDB ClusterSet».
Устраните любые clusterErrors и statusText, возвращённые операцией <ClusterSet>.status().
Проверьте каждый кластер в ClusterSet, выполнив команду <Cluster>.status(), и устраните любые проблемы. Дополнительную информацию о <Cluster>.status() см. в разделе «Проверка состояния кластера с помощью Cluster.status()».
Проверьте информацию обо всех зарегистрированных экземплярах MySQL Router, выполнив команду <ClusterSet>.listRouters(). Дополнительную информацию см. в разделе «Интеграция MySQL Router с InnoDB ClusterSet».

Эти команды позволяют проверить успешность обновления или определить, требуется ли выполнить дополнительные шаги.

Примечание

Дополнительные шаги зависят от того, сколько версий было пропущено, от версии обновления и от исходной версии.

Начните проверку после обновления, проверив состояние InnoDB ClusterSet. Эта проверка использует <ClusterSet>.status({extended:1}) operation.

В данном примере мы используем команду <ClusterSet>.status({extended:1}):

  mysql-js><ClusterSet>.status({extended:1})
{
    "clusters": {
        "cluster1": {
            "clusterRole": "PRIMARY",
            "globalStatus": "OK",
            "primary": "127.0.0.1:3310",
            "status": "OK_NO_TOLERANCE",
            "statusText": "Cluster is NOT tolerant to any failures.",
            "topology": {
                "127.0.0.1:3310": {
                    "address": "127.0.0.1:3310",
                    "memberRole": "PRIMARY",
                    "mode": "R/W",
                    "status": "ONLINE",
                    "version": "8.0.28"
                }
            },
            "transactionSet": "c0361cad-9093-11ec-94ce-0a0027000010:1-90,c0362acf-9093-11ec-94ce-0a0027000010:1"
        },
        "replicacluster1": {
            "clusterErrors": [
                "ERROR: Cluster members are reachable but they're all OFFLINE.",
                "WARNING: Replication from the Primary Cluster not in expected state"
            ],
            "clusterRole": "REPLICA",
            "clusterSetReplication": {
                "applierStatus": "OFF",
                "applierThreadState": "",
                "applierWorkerThreads": 4,
                "receiver": "127.0.0.1:3320",
                "receiverStatus": "OFF",
                "receiverThreadState": "",
                "source": "127.0.0.1:3310"
            },
            "clusterSetReplicationStatus": "STOPPED",
            "globalStatus": "NOT_OK",
            "status": "OFFLINE",
            "statusText": "All members of the group are OFFLINE",
            "topology": {
                "127.0.0.1:3320": {
                    "address": "127.0.0.1:3320",
                    "instanceErrors": [
                        "NOTE: group_replication is stopped."
                    ],
                    "memberRole": "SECONDARY",
                    "memberState": "OFFLINE",
                    "mode": "R/O",
                    "status": "(MISSING)",
                    "version": "8.0.28"
                }
            },
            "transactionSet": "1ec95a0b-9094-11ec-9bc5-0a0027000010:1,c0361cad-9093-11ec-94ce
                               -0a0027000010:1-90,c0362acf-9093-11ec-94ce-0a0027000010:1",
            "transactionSetConsistencyStatus": "OK",
            "transactionSetErrantGtidSet": "",
            "transactionSetMissingGtidSet": ""
        },
        "replicacluster2": {
            "clusterRole": "REPLICA",
            "clusterSetReplication": {
                "applierStatus": "APPLIED_ALL",
                "applierThreadState": "Waiting for an event from Coordinator",
                "applierWorkerThreads": 4,
                "receiver": "127.0.0.1:3330",
                "receiverStatus": "ON",
                "receiverThreadState": "Waiting for source to send event",
                "source": "127.0.0.1:3310"
            },
            "clusterSetReplicationStatus": "OK",
            "globalStatus": "OK",
            "status": "OK_NO_TOLERANCE",
            "statusText": "Cluster is NOT tolerant to any failures.",
            "topology": {
                "127.0.0.1:3330": {
                    "address": "127.0.0.1:3330",
                    "memberRole": "PRIMARY",
                    "mode": "R/O",
                    "replicationLagFromImmediateSource": "",
                    "replicationLagFromOriginalSource": "",
                    "status": "ONLINE",
                    "version": "8.0.28"
                }
            },
            "transactionSet": "329dc243-9094-11ec-b9dd-0a0027000010:1,c0361cad-9093-11ec
                               -94ce-0a0027000010:1-90,c0362acf-9093-11ec-94ce-0a0027000010:1",
            "transactionSetConsistencyStatus": "OK",
            "transactionSetErrantGtidSet": "",
            "transactionSetMissingGtidSet": ""
        }
    },
    "domainName": "clusterset1",
    "globalPrimaryInstance": "127.0.0.1:3310",
    "metadataServer": "127.0.0.1:3310",
    "primaryCluster": "cluster1",
    "status": "AVAILABLE",
    "statusText": "Primary Cluster available, there are issues with a Replica cluster."
}

Дополнительную информацию об операции <ClusterSet>.status() см. в ClusterSet.status().

Устраните любые ошибки, возвращённые операцией <ClusterSet>.status({extended:1}).

В этом примере ошибка возвращается в clusterErrors, сообщая, что операция <ClusterSet>.status({extended:1}) не смогла подключиться к онлайн-членам, и с сообщением statusText, что основной кластер доступен, но есть проблемы с кластером реплики в InnoDB ClusterSet.
```
  ...
  "replicacluster1": {
    "clusterErrors": [
                  "ERROR: Could not connect to any ONLINE members but there are unreachable instances
                          that could still be ONLINE."
              ],
  ...
   "statusText": "Primary Cluster available, there are issues with a Replica cluster."
}
```
В этом примере нам нужно проверить состояние InnoDB Cluster replicacluster1 и убедиться, что он снова стал онлайн.

После устранения проблем, возвращённых операцией <ClusterSet>.status({extended:1}), проверьте состояние каждого InnoDB Cluster в ClusterSet.

Проверьте состояние каждого InnoDB Cluster, выполнив команду <Cluster>.status().

В следующем примере <Cluster>.status({extended: true}), используемая для получения более подробной информации о состоянии InnoDB Cluster, возвращает две проблемы:

    mysqlsh> cluster.status({extended: true});
    {
        "clusterName": "MyCluster",
        "defaultReplicaSet": {
            "GRProtocolVersion": "8.0.16",
            "groupName": "459ec434-8926-11ec-b8c3-02001707f44a",
            "groupViewChangeUuid": "AUTOMATIC",
            "groupViewId": "16443558036060755:13",
            "name": "default",
            "ssl": "REQUIRED",
            "status": "OK",
            "statusText": "Cluster is ONLINE and can tolerate up to ONE failure.",
            "topology": {
                "example-el7-1644251369:33311": {
                    "address": "example-el7-1644251369:33311",
                    "applierWorkerThreads": 4,
                    "fenceSysVars": [],
                    "instanceErrors": [
                        "NOTE: instance server_id is not registered in the metadata.
                               Use cluster.rescan() to update the metadata.",
                        "NOTE: The required parallel-appliers settings are not enabled on the instance.
                               Use dba.configureInstance() to fix it."
                    ],
                    "memberId": "247131ab-8926-11ec-850b-02001707f44a",
                    "memberRole": "PRIMARY",
                    "memberState": "ONLINE",
                    "mode": "R/W",
                    "readReplicas": {},
                    "replicationLag": null,
                    "role": "HA",
                    "status": "ONLINE",
                    "version": "8.0.28"
                },
                "example-el7-1644251369:33314": {
                    "address": "example-el7-1644251369:33314",
                    "applierWorkerThreads": 4,
                    "fenceSysVars": [],
                    "instanceErrors": [
                        "NOTE: instance server_id is not registered in the metadata.
                               Use cluster.rescan() to update the metadata.",
                        "NOTE: The required parallel-appliers settings are not enabled on the instance.
                               Use dba.configureInstance() to fix it."
                    ],
                    "memberId": "303dcfa7-8926-11ec-a6e5-02001707f44a",
                    "memberRole": "PRIMARY",
                    "memberState": "ONLINE",
                    "mode": "R/W",
                    "readReplicas": {},
                    "replicationLag": null,
                    "role": "HA",
                    "status": "ONLINE",
                    "version": "8.0.28"
                },
                "example-el7-1644251369:33317": {
                    "address": "example-el7-1644251369:33317",
                    "applierWorkerThreads": 4,
                    "fenceSysVars": [],
                    "instanceErrors": [
                        "NOTE: instance server_id is not registered in the metadata.
                               Use cluster.rescan() to update the metadata.",
                        "NOTE: The required parallel-appliers settings are not enabled on the instance.
                               Use dba.configureInstance() to fix it."
                    ],
                    "memberId": "3bb2592e-8926-11ec-8b6f-02001707f44a",
                    "memberRole": "PRIMARY",
                    "memberState": "ONLINE",
                    "mode": "R/W",
                    "readReplicas": {},
                    "replicationLag": null,
                    "role": "HA",
                    "status": "ONLINE",
                    "version": "8.0.28"
                }
            },
            "topologyMode": "Multi-Primary"
        },
        "groupInformationSourceMember": "example-el7-1644251369:33311",
        "metadataVersion": "2.1.0"
    }

<Cluster>.status({extended: true}) отображает более подробную информацию о кластере. В этом примере мы используем логическое значение true, которое эквивалентно <Cluster>.status({'extended':1}). Дополнительную информацию см. в разделе «Проверка состояния кластера с помощью Cluster.status()».

instanceErrors предполагает, что в этом обновлении необходимо выполнить команды <Cluster>.rescan() и dba.configureInstance() для каждого члена InnoDB Cluster:

...
"NOTE: instance server_id is not registered in the
metadata. Use cluster.rescan() to update the metadata.",
"NOTE: The required parallel-appliers settings are not
enabled on the instance. Use dba.configureInstance() to fix it."
...

Операция <Cluster>.rescan() позволяет повторно сканировать InnoDB Cluster для новых и устаревших экземпляров Group Replication, а также изменения используемого режима топологии. Дополнительную информацию см. в разделе «Повторное сканирование кластера».

mysqlsh> cluster1.rescan();
Rescanning the cluster...

Result of the rescanning operation for the 'MyCluster1' cluster:
{
    "name": "MyCluster1",
    "newTopologyMode": null,
    "newlyDiscoveredInstances": [],
    "unavailableInstances": [],
    "updatedInstances": []
}

Примечание

Вы можете выполнить <Cluster>.rescan() только для отдельных кластеров ClusterSet, а не для всего ClusterSet.

Функция dba.configureInstance() проверяет все настройки, необходимые для использования экземпляра в InnoDB Cluster. Дополнительную информацию см. в разделе «Настройка производственных экземпляров для использования в InnoDB Cluster».

В этом примере мы выполним команду dba.configureInstance() для каждого члена кластера, чтобы убедиться, что настройки параллельных приложений включены в экземпляре:

  mysqlsh> dba.configureInstance('cladmin:cladminpw@localhost:33311')
    The instance 'example-el7-1644251369:33311' belongs to an InnoDB Cluster.
    Configuring local MySQL instance listening at port 33311 for use in an InnoDB cluster...

    This instance reports its own address as ^[[1mexample-el7-1644251369:33311^[[0m
    Clients and other cluster members will communicate with it through this address by default.
    If this is not correct, the report_host MySQL system variable should be changed.

    applierWorkerThreads will be set to the default value of 4.

    ^[[36mNOTE: ^[[0mSome configuration options need to be fixed:
    +----------------------------------------+---------------+----------------+----------------------------+
    | Variable                               | Current Value | Required Value | Note                       |
    +----------------------------------------+---------------+----------------+----------------------------+
    | binlog_transaction_dependency_tracking | COMMIT_ORDER  | WRITESET       | Update the server variable |
    +----------------------------------------+---------------+----------------+----------------------------+

    Configuring instance...
    The instance 'example-el7-1644251369:33311' was configured to be used in an InnoDB cluster.

После устранения проблем, возвращённых операциями <ClusterSet>.status({extended:1}) и <Cluster>.status({extended:1}), необходимо выполнить команду <ClusterSet>.listRouters().

<ClusterSet>.listRouters() возвращает информацию обо всех зарегистрированных экземплярах MySQL Router. Информация включает имя каждого экземпляра MySQL Router в метаданных, имя хоста, порты и т. д. Дополнительную информацию см. в разделе «Интеграция MySQL Router с InnoDB ClusterSet».

Например, в нашем примере ClusterSet мы выполним команду:
```
mysqlsh> <ClusterSet>.listRouters();

WARNING: The following Routers were bootstrapped before the ClusterSet was created: [EXAMPLE::R1].
         Please re-bootstrap the Routers to ensure the optimal configurations are set.

{
    "domainName": "MyClusterSet",
    "routers": {
        "EXAMPLE::R1": {
            "hostname": "EXAMPLE",
            "lastCheckIn": "2022-02-23 07:14:50",
            "roPort": 6447,
            "roXPort": 6449,
            "routerErrors": [
                "WARNING: Router needs to be re-bootstraped."
            ],
            "rwPort": 6446,
            "rwXPort": 6448,
            "targetCluster": null,
            "version": "8.0.28"
        }
    }
}
```
Возвращённая информация содержит:
- Имя экземпляра MySQL Router.
- Время последней проверки (timestamp), генерируемое периодическим пингом MySQL Router, хранящимся в метаданных.
- Имя хоста, на котором запущен экземпляр MySQL Router.
- Порты для чтений и записи, опубликованные MySQL Router для подключений по протоколу classic MySQL.
- Порты для чтений и записи, опубликованные MySQL Router для подключений по протоколу X.
- Имя целевого кластера. В этом примере MySQL Router перенаправляет трафик от клиентских приложений к кластеру в развертывании InnoDB ClusterSet, который в настоящее время является основным кластером.
- Версия этого экземпляра MySQL Router.
В этом примере также указана информация о routerErrors.

routerErrors сообщает, что MySQL Router необходимо перезапустить. Причина этой ошибки заключается в том, что если вы создаёте ClusterSet на основе автономного Cluster, MySQL Router должен быть перезапущен, чтобы уведомить Router о работе с ClusterSet.

Устраните эти предупреждения, чтобы завершить проверки после обновления. Если вы не получите никаких предупреждений, значит, проверки после обновления завершены.