Pré-verificação de upgrade 8.0 → 8.4 LTS (util.checkForServerUpgrade)

Comando

# State the target version explicitly; the Shell must be the same version as the target or newer
mysqlsh root@db1:3306 -- util check-for-server-upgrade --target-version=8.4.10 --output-format=TEXT
# JSON output for automation, including a my.cnf check
mysqlsh root@db1:3306 -- util check-for-server-upgrade --target-version=8.4.10 --output-format=JSON --config-path=/etc/my.cnf > /tmp/upgrade_check.json

O que faz

Verifica o servidor atual contra a versão de destino: variáveis e privilégios removidos, parâmetros com novos defaults, métodos de autenticação legados, definições de coluna inválidas, problemas de foreign key e de partição. Achados de nível erro bloqueiam o upgrade.

Quando usar

Antes de todo upgrade major / LTS; execute novamente após corrigir os achados.

Atenção

Revise também os avisos: na 8.4 defaults como innodb_io_capacity (10000), innodb_log_buffer_size (64 MB), innodb_adaptive_hash_index (OFF), innodb_change_buffering (none), innodb_buffer_pool_instances e group_replication_consistency mudam e podem afetar a performance; fixe no my.cnf os valores cujo comportamento atual você quer manter. Privilégios removidos, como SET_USER_ID, são descartados durante o upgrade. Faça o upgrade de uma réplica primeiro, observe-a sob carga e então faça o switchover; downgrade binário da 8.4 para a 8.0 não é suportado, então o plano de retorno é um backup lógico ou uma réplica mantida na versão antiga.