

# Actualización de una instancia de base de datos de RDS Custom para Oracle
<a name="custom-upgrading-modify"></a>

A fin de actualizar su instancia de base de datos para RDS Custom para Oracle, modifíquela para utilizar una nueva CEV. Esta CEV puede contener binarios de base de datos nuevos o una AMI nueva. Por ejemplo, para actualizar la instancia de base de datos Oracle Linux 7.9 a Oracle Linux 8, especifique la AMI más reciente, que utiliza Oracle Linux 8. Para actualizar la base de datos y el sistema operativo, debe llevar a cabo dos actualizaciones independientes.

**nota**  
Si actualiza la base de datos, RDS Custom actualiza automáticamente las réplicas de lectura después de actualizar la instancia de base de datos principal. Al actualizar el sistema operativo, debe actualizar las réplicas manualmente.

Antes de empezar, revise [Requisitos de las actualizaciones de RDS Custom para Oracle](custom-upgrading.md#custom-upgrading-reqs) y [Consideraciones de las actualizaciones de base de datos de RDS Custom for Oracle](custom-upgrading-considerations.md). 

## Consola
<a name="custom-upgrading-modify.CON"></a>

**Para modificar una instancia de base de datos de RDS Custom para Oracle**

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. En el panel de navegación, elija **Bases de datos** y, luego, elija la instancia de base de datos de RDS Custom para Oracle que desea actualizar.

1. Elija **Modify** (Modificar). Aparece la página **Modify DB instance (Modificar instancia de base de datos)**.

1. En **Versión del motor de base de datos**, elija una CEV diferente. Haga lo siguiente:
   + Si va a aplicar parches a la base de datos, asegúrese de que la CEV especifique binarios de base de datos distintos de los que utiliza la instancia de base de datos; además, compruebe que no especifique una AMI distinta de la AMI que utiliza actualmente la instancia de base de datos.
   + Si va a aplicar parches al sistema operativo, asegúrese de que la CEV especifique una AMI distinta de la que utiliza actualmente la instancia de base de datos; además, compruebe que no especifique binarios distintos de base de datos.
**aviso**  
Al parchear el sistema operativo, se pierden los datos del volumen raíz y cualquier personalización existente del sistema operativo.

1. Elija **Continue** (Continuar) para ver el resumen de las modificaciones.

   Para aplicar los cambios inmediatamente, elija **Apply immediately** (Aplicar inmediatamente).

1. Si los cambios son correctos, elija **Modify DB instance** (Modificar instancia de base de datos). O bien, elija **Back** (Atrás) para editar los cambios o **Cancel** (Cancelar) para cancelarlos.

## AWS CLI
<a name="custom-upgrading-modify.CLI"></a>

En los siguientes ejemplos, se muestran posibles situaciones de actualización. En los ejemplos, se da por sentado que ha creado una instancia de base de datos de RDS Custom para Oracle con las siguientes características:
+ Instancia de base de datos denominada `my-custom-instance`
+ CEV con el nombre `19.my_cev1`
+ Oracle Database 19c con arquitectura no CDB
+ Oracle Linux 8 con AMI `ami-1234`

La última AMI proporcionada por el servicio es `ami-2345`. Puede encontrar las AMI ejecutando el comando de la CLI `describe-db-engine-versions`:

**Topics**
+ [Actualización del SO](#custom-upgrading-modify.CLI.os)
+ [Actualización de la base de datos](#custom-upgrading-modify.CLI.db)

### Actualización del SO
<a name="custom-upgrading-modify.CLI.os"></a>

En este ejemplo, desea actualizar `ami-1234` a `ami-2345`, que es la AMI más reciente proporcionada por el servicio. Como se trata de una actualización del sistema operativo, los binarios de base de datos para `ami-1234` y `ami-2345` deben ser los mismos. Se crea una nueva CEV con el nombre `19.my_cev2`, basada en `19.my_cev1`.

**Example**  
Para Linux, macOS o Unix:  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev2 \
    --description "Non-CDB CEV based on ami-2345" \
    --kms-key-id key-name \
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 \
    --image-id ami-2345
```
Para Windows:  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev2 ^
    --description "Non-CDB CEV based on ami-2345" ^
    --kms-key-id key-name ^
    --source-custom-db-engine-version-identifer arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/12345678-ab12-1234-cde1-abcde123456789 ^
    --image-id ami-2345
```

Para actualizar una instancia de base de datos de RDS Custom, utilice el comando de la AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) con los siguientes parámetros:
+ `--db-instance-identifier`: especifique la instancia de base de datos de RDS Custom para Oracle que se va a actualizar.
+ `--engine-version`: especifique la CEV que tiene la nueva AMI.
+ `--no-apply-immediately` \$1 `--apply-immediately`: especifique si desea realizar la actualización inmediatamente o esperar hasta el periodo de mantenimiento programado

En el siguiente ejemplo se actualiza `my-custom-instance` a la versión `19.my_cev2`. Solo se actualiza el sistema operativo.

**Example**  
Para Linux, macOS o Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev2 \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev2 ^
    --apply-immediately
```

### Actualización de la base de datos
<a name="custom-upgrading-modify.CLI.db"></a>

En este ejemplo, desea aplicar el parche p35042068 de Oracle a su instancia de base de datos para RDS para Oracle. Como ha actualizado su sistema operativo en [Actualización del SO](#custom-upgrading-modify.CLI.os), la instancia de base de datos está utilizando actualmente `19.my_cev2`, que se basa en `ami-2345`. Ha creado una nueva CEV con el nombre `19.my_cev3` que también utiliza `ami-2345`, pero especifica un nuevo manifiesto JSON en la variable de entorno `$MANIFEST`. Por lo tanto, solo los binarios de la base de datos son diferentes en la nueva CEV y en la CEV que la instancia está utilizando actualmente.

**Example**  
Para Linux, macOS o Unix:  

```
aws rds create-custom-db-engine-version \
    --engine custom-oracle-ee \
    --engine-version 19.my_cev3 \
    --description "Non-CDB CEV with p35042068 based on ami-2345" \
    --kms-key-id key-name \
    --image-id ami-2345 \
    --manifest $MANIFEST
```
Para Windows:  

```
aws rds create-custom-db-engine-version ^
    --engine custom-oracle-ee ^
    --engine-version 19.my_cev3 ^
    --description "Non-CDB CEV with p35042068 based on ami-2345" ^
    --kms-key-id key-name ^
    --image-id ami-2345 ^
    --manifest $MANIFEST
```

En el siguiente ejemplo, `my-custom-instance` se actualiza a la versión de motor `19.my_cev3`. Solo se actualiza la base de datos.

**Example**  
Para Linux, macOS o Unix:  

```
aws rds modify-db-instance \
    --db-instance-identifier my-custom-instance \
    --engine-version 19.my_cev3 \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my-custom-instance ^
    --engine-version 19.my_cev3 ^
    --apply-immediately
```