# Pasos para realizar una actualización local
También le recomendamos que revise el material de referencia en [Cómo funciona la actualización de la versión principal en el lugar Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence).
Realice cualquier planificación y prueba previas a la actualización, tal y como se describe en [Planificación de una actualización de versión principal para un clúster Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Planning).
## Consola
En el ejemplo siguiente se actualiza el clúster de base de datos `mydbcluster-cluster` a la versión Aurora MySQL 3.04.1.
**Para actualizar la versión principal de un clúster de base de datos Aurora MySQL**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Si utilizó un grupo de parámetros personalizado con el clúster de base de datos original, cree un grupo de parámetros compatible con la nueva versión principal. Realice los ajustes necesarios en los parámetros de configuración del nuevo grupo de parámetros. Para obtener más información, consulte [Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster](#AuroraMySQL.Upgrading.ParamGroups).
1. En el panel de navegación, seleccione **Databases (Bases de datos)**.
1. En la lista, elija el clúster de base de datos que desea modificar.
1. Elija **Modify**.
1. Para **Version** (Versión), elija una nueva versión principal de Aurora.
También le recomendamos que utilice la versión secundaria de la versión principal. A continuación, elegimos la versión predeterminada actual.
![\[Actualización in situ de un clúster de base de datos Aurora MySQL de la versión 2 a la versión 3\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/ams-upgrade-v2-v3.png)
1. Elija **Continue**.
1. En la página siguiente, especifique cuándo realizar la actualización. Seleccione **During the next scheduled maintenance window (Durante la siguiente ventana de mantenimiento programado)** o **Immediately (Inmediatamente)**.
1. (Opcional) Examine periódicamente la página **Events** (Eventos) de la consola RDS durante la actualización. Esto le ayuda a supervisar el progreso de la actualización e identificar cualquier problema. Si la actualización encuentra algún problema, consulte [Solución de problemas para la actualización Aurora MySQL en el lugar](AuroraMySQL.Upgrading.Troubleshooting.md) para conocer los pasos a seguir.
1. Si creó un nuevo grupo de parámetros al inicio de este procedimiento, asocie el grupo de parámetros personalizados con el clúster actualizado. Para obtener más información, consulte [Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster](#AuroraMySQL.Upgrading.ParamGroups).
**nota**
Para realizar este paso, deberá reiniciar el clúster de nuevo para aplicar el nuevo grupo de parámetros.
1. (Opcional) Después de completar las pruebas posteriores a la actualización, elimine la instantánea manual que Aurora creó al comienzo de la actualización.
## AWS CLI
Para actualizar la versión principal de un clúster de base de datos de Aurora MySQL, utilice el comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) de la AWS CLI con los siguientes parámetros requeridos:
+ `--db-cluster-identifier`
+ `--engine-version`
+ `--allow-major-version-upgrade`
+ `--apply-immediately` o `--no-apply-immediately`
Si el clúster utiliza algún grupo de parámetros personalizados, incluya también una o ambas opciones:
+ `--db-cluster-parameter-group-name`, si el clúster utiliza un grupo de parámetros de clúster personalizado
+ `--db-instance-parameter-group-name`, si alguna instancia del clúster utiliza un grupo de parámetros de base de datos personalizado
En el ejemplo siguiente se actualiza el clúster de base de datos `sample-cluster` a la versión Aurora MySQL 3.04.1. La actualización se realiza inmediatamente, en lugar de esperar la siguiente ventana de mantenimiento.
**Example**
Para Linux, macOS o Unix:
```
aws rds modify-db-cluster \
--db-cluster-identifier sample-cluster \
--engine-version 8.0.mysql_aurora.3.04.1 \
--allow-major-version-upgrade \
--apply-immediately
```
En Windows:
```
aws rds modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine-version 8.0.mysql_aurora.3.04.1 ^
--allow-major-version-upgrade ^
--apply-immediately
```
Puede combinar otros comandos de CLI con `modify-db-cluster` para crear un proceso automatizado de extremo a extremo para realizar y verificar actualizaciones. Para obtener más información y ejemplos, consulte [Tutorial de actualización de Aurora MySQL en el lugar](AuroraMySQL.Upgrading.Tutorial.md).
**nota**
Si el clúster forma parte de una base de datos global Aurora, el procedimiento de actualización en el lugar es ligeramente diferente. Se llama a la operación de comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) en lugar de `modify-db-cluster`. Para obtener más información, consulte [Actualizaciones mayores en el lugar para bases de datos globales](#AuroraMySQL.Upgrading.GlobalDB).
## API de RDS
Para actualizar la versión principal de un clúster de base de datos Aurora MySQL, utilice la operación de la API de RDS [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) con los siguientes parámetros requeridos:
+ `DBClusterIdentifier`
+ `Engine`
+ `EngineVersion`
+ `AllowMajorVersionUpgrade`
+ `ApplyImmediately` (establecido en `true` o `false`)
**nota**
Si el clúster forma parte de una base de datos global Aurora, el procedimiento de actualización en el lugar es ligeramente diferente. Se llama a la operación [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalClusterParameterGroup.html) en lugar de `ModifyDBCluster`. Para obtener más información, consulte [Actualizaciones mayores en el lugar para bases de datos globales](#AuroraMySQL.Upgrading.GlobalDB).
## Cómo afectan las actualizaciones en el lugar a los grupos de parámetros de un clúster
Los grupos de parámetros de Aurora tienen diferentes conjuntos de opciones de configuración para los clústeres compatibles con MySQL 5.7 u 8.0. Al realizar una actualización en el centro, el clúster actualizado y todas sus instancias deben utilizar los grupos de parámetros de clúster e instancia correspondientes.
Es posible que el clúster y las instancias usen los grupos de parámetros predeterminados compatibles con la versión 5.7. Si es así, el clúster y la instancia actualizados comienzan con los grupos predeterminados de parámetros compatibles con 8.0. Si su clúster e instancias utilizan algún grupo de parámetros personalizado, asegúrese de crear los correspondientes grupos de parámetros compatibles con 8.0. También asegúrese de especificarlos durante el proceso de actualización.
**nota**
Para la mayoría de las configuraciones de parámetros, puede elegir el grupo de parámetros personalizado en dos puntos. Esto es al crear el clúster o asociar el grupo de parámetros al clúster más adelante.
Sin embargo, si utiliza una configuración no predeterminada para el parámetro `lower_case_table_names`, debe configurar el grupo de parámetros personalizado con esta configuración de antemano. A continuación, especifique el grupo de parámetros durante la restauración de instantáneas para la creación de clúster. Cualquier cambio en el parámetro `lower_case_table_names` no tiene efecto después de crear el clúster.
Le recomendamos que utilice la misma configuración para `lower_case_table_names` cuando actualice de la versión 2 de Aurora MySQL a la versión 3.
Con una base de datos global de Aurora basada en Aurora MySQL, no se puede realizar una actualización local desde la versión 2 a la versión 3 de Aurora MySQL si el parámetro `lower_case_table_names` está activado. Para obtener más información sobre los métodos que puede utilizar, consulte [Actualizaciones de la versión principal](aurora-global-database-upgrade.md#aurora-global-database-upgrade.major).
**importante**
Si especifica algún grupo de parámetros personalizado durante el proceso de actualización, asegúrese de reiniciar manualmente el clúster una vez finalizada la actualización. Al hacerlo, el clúster comienza a usar la configuración de parámetros personalizados.
## Cambios en las propiedades del clúster entre versiones de Aurora MySQL
Cuando actualice de la versión 2 a la versión 3 de Aurora MySQL, asegúrese de comprobar cualquier aplicación o script que utilice para configurar o administrar clústeres e instancias de base de datos de Aurora MySQL.
Además, cambie el código que manipula los grupos de parámetros para tener en cuenta el hecho de que los nombres de grupos de parámetros predeterminados son diferentes para los clústeres compatibles con 5.7 y 8.0. Los nombres de los grupos de parámetros predeterminados para los clústeres de las versiones 2 y 3 de Aurora MySQL son `default.aurora-mysql5.7` y `default.aurora-mysql8.0`, respectivamente.
Por ejemplo, es posible que tenga código como el siguiente que se aplique al clúster antes de una actualización.
```
# Check the default parameter values for MySQL 5.7–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql5.7 --region us-east-1
```
Después de actualizar la versión principal del clúster, modifique ese código de la siguiente manera.
```
# Check the default parameter values for MySQL 8.0–compatible clusters.
aws rds describe-db-parameters --db-parameter-group-name default.aurora-mysql8.0 --region us-east-1
```
## Actualizaciones mayores en el lugar para bases de datos globales
Para una base de datos global de Aurora, actualice el clúster de la base de datos global. Aurora actualiza automáticamente todos los clústeres al mismo tiempo y se asegura de que todos ejecuten la misma versión del motor. Este requisito se debe a que cualquier cambio en las tablas del sistema, formatos de archivo de datos, etc., se replican automáticamente en todos los clústeres secundarios.
Siga las instrucciones en [Cómo funciona la actualización de la versión principal en el lugar Aurora MySQL](AuroraMySQL.Updates.MajorVersionUpgrade.md#AuroraMySQL.Upgrading.Sequence). Cuando especifique qué actualizar, asegúrese de elegir el clúster de base de datos global en lugar de uno de los clústeres que contiene.
Si utiliza la Consola de administración de AWS, elija el elemento con el rol **Global database** (Base de datos global).
![\[Actualización del clúster de base de datos global\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-databases-major-upgrade-global-cluster.png)
Si utiliza la AWS CLI o la API de RDS, inicie el proceso de actualización llamando al comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) o la operación [ModifyGlobalCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyGlobalCluster.html). Se usa uno de estos en lugar de `modify-db-cluster` o `ModifyDBCluster`.
**nota**
No puede especificar un grupo de parámetros personalizado para el clúster de base de datos global mientras realiza una actualización importante de la versión de esa base de datos global de Aurora. Cree grupos de parámetros personalizados en cada región del clúster global. A continuación, aplíquelos manualmente a los clústeres regionales después de la actualización.
Para actualizar la versión principal de un clúster de base de datos global de Aurora MySQL, utilice el comando [modify-global-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-global-cluster.html) de la AWS CLI con los siguientes parámetros requeridos:
+ `--global-cluster-identifier`
+ `--engine aurora-mysql`
+ `--engine-version`
+ `--allow-major-version-upgrade`
En el ejemplo siguiente se actualiza el clúster de base de datos global a la versión 2.10.2 de Aurora MySQL.
**Example**
Para Linux, macOS o Unix:
```
aws rds modify-global-cluster \
--global-cluster-identifier global_cluster_identifier \
--engine aurora-mysql \
--engine-version 5.7.mysql_aurora.2.10.2 \
--allow-major-version-upgrade
```
En Windows:
```
aws rds modify-global-cluster ^
--global-cluster-identifier global_cluster_identifier ^
--engine aurora-mysql ^
--engine-version 5.7.mysql_aurora.2.10.2 ^
--allow-major-version-upgrade
```
## Consideraciones sobre el Backtrack
Si el clúster que actualizó tenía habilitada la característica Backtrack, no podrá realizar un retroceso del clúster actualizado a una hora anterior a la actualización.