

# Creación y administración de versiones de motor BYOM para RDS para SQL Server
<a name="sqlserver-byom-creating-cev"></a>

La creación de una versión del motor BYOM requiere una configuración única (verificación de la Movilidad de licencias, obtención de contenido multimedia RTM y carga en S3). Tras la configuración, puede crear versiones del motor mediante la consola de Amazon RDS o la AWS CLI.

## Antes de empezar
<a name="sqlserver-byom-creating-cev.before-you-begin"></a>

### Paso 1: finalización de la verificación de Movilidad de licencias de Microsoft
<a name="sqlserver-byom-creating-cev.step1"></a>

Se requiere Movilidad de licencias mediante Software Assurance para BYOM. Debe tener una cobertura activa de Software Assurance en las licencias de SQL Server antes de implementarlas en AWS.

Para completar el proceso de verificación:

1. **Revise la aptitud** Visite la [página de Movilidad de licencias de AWS](https://aws.amazon.com/windows/resources/licensemobility/) para revisar los requisitos y los criterios de aptitud.

1. **Envíe el formulario de verificación** Descargue y complete el [formulario de verificación de Movilidad de licencias de Microsoft](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx). Envíe el formulario a Microsoft a través del socio de licencias o directamente.

1. **Espere la aprobación** Microsoft enviará un correo electrónico de confirmación cuando se apruebe la verificación.

Debe enviar el formulario a Microsoft directamente o a través de su distribuidor de Microsoft en un plazo de 10 días a partir de la introducción de los productos en AWS.

**importante**  
AWS no valida ni exige el cumplimiento de las licencias de Microsoft. Es responsable de mantener el cumplimiento de los contratos de licencia de Microsoft.

### Paso 2: obtención de los medios de instalación de SQL Server
<a name="sqlserver-byom-creating-cev.step2"></a>

Descargue el archivo Release to Manufacturing (RTM) de la versión principal de SQL Server que desee utilizar. El archivo RTM es el medio de instalación básico para una versión y edición principales de SQL Server (por ejemplo, SQL Server 2019 Enterprise Edition).

Puede obtener el archivo RTM de uno de los siguientes orígenes de Microsoft:
+ **Suscripción de Visual Studio** Si tiene una suscripción de Visual Studio activa, descargue el archivo RTM desde la [página de descargas para suscriptores](https://visualstudio.microsoft.com/subscriptions/).
+ **Centro de administración de Microsoft 365** Si ha adquirido productos mediante licencias por volumen, descargue el archivo RTM desde la [página de descargas del centro de administración de Microsoft 365](https://admin.microsoft.com).

**importante**  
Descargue solo el archivo ISO basado en Core en inglés. No utilice el archivo ISO basado en Server\+CAL.

### Paso 3: carga de los medios de instalación en Amazon S3
<a name="sqlserver-byom-creating-cev.step3"></a>

Cargue el archivo RTM de SQL Server en un bucket de Amazon S3 de la misma región de AWS y cuenta en la que piensa crear la versión del motor BYOM. Para cargar el archivo RTM mediante la AWS CLI:

```
aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/
```

**nota**  
Si no proporciona un archivo de actualización acumulativa (CU) durante la creación del motor BYOM, Amazon RDS descarga automáticamente la CU requerida de Microsoft al crear la versión del motor.

## Creación de una versión del motor BYOM
<a name="sqlserver-byom-creating-cev.creating"></a>

Use `describe-db-engine-versions` para verificar qué versiones de motor son aptas para crear una versión de motor BYOM. Para ver las versiones compatibles, consulte [Bring Your Own Media (BYOM) para RDS para SQL Server](sqlserver-byom.md).

### Consola
<a name="sqlserver-byom-creating-cev.console"></a>

1. Inicie sesión en la [Consola de administración de AWS](https://console.aws.amazon.com/rds/) y abra la consola de Amazon RDS.

1. En el panel de navegación, elija **Custom engine versions** (Versiones de motor personalizadas).

1. En el menú desplegable, seleccione **RDS para SQL Server**.

1. Elija **Crear versión de motor personalizada**.

1. Para **Tipo de motor**, elija **SQL Server**.

1. En **Tipo de administración de base de datos**, elija **Amazon RDS Custom**.

1. Para **Edición**, elija una de las siguientes opciones: 
   + SQL Server Enterprise Edition
   + SQL Server Standard Edition

1. Para **Versión de motor**, elija la versión de SQL Server que coincida con los archivos de instalación (por ejemplo, SQL Server 2022 `16.00.4175.1.v1`).

1. Para **Contenido multimedia de instalación**, ingrese el URI de S3 que contiene el contenido multimedia RTM de SQL Server o elija **Examinar S3** para ubicar y seleccionar el archivo.

1. Elija **Crear versión de motor personalizada**.

La consola muestra la nueva versión del motor BYOM con un estado inicial de **Pendiente de validación**. El estado progresa automáticamente. Para obtener más información, consulte [Estados del ciclo de vida de la versión del motor BYOM](#sqlserver-byom-creating-cev.lifecycle).

### CLI
<a name="sqlserver-byom-creating-cev.cli"></a>

Utilice el comando `create-custom-db-engine-version` para crear una versión del motor BYOM a partir del medio de instalación. Amazon RDS descarga automáticamente la actualización acumulativa requerida de Microsoft.

```
aws rds create-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --database-installation-files-s3-bucket-name my-sqlserver-media \
    --database-installation-files-s3-prefix "ISOs/" \
    --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso"
```

**Respuesta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    "DatabaseInstallationFiles": [
        "SQLServer2022-x64-ENU-Enterprise.iso"
    ],
    "DBEngineDescription": "Microsoft SQL Server Enterprise Edition",
    "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    ....
    "Status": "pending-validation",
    .....
}
```

**Parámetros de la CLI**


| Parámetro | Obligatorio | Descripción | 
| --- | --- | --- | 
| --engine | Sí | Tipo de motor de base de datos: sqlserver-ee, sqlserver-se. | 
| --engine-version | Sí | La versión del motor de destino (por ejemplo, 16.00.4175.1.v1). | 
| --database-installation-files-s3-bucket-name | Sí | El nombre del bucket de S3 que contiene el contenido multimedia de instalación. El bucket debe estar en la misma región de AWS que la versión del motor BYOM. | 
| --database-installation-files-s3-prefix | No | El prefijo de clave de S3 (ruta de la carpeta) donde se almacenan los archivos multimedia de instalación. | 
| --database-installation-files | Sí | Los nombres de los archivos de los medios de instalación. | 

**nota**  
Cuando se utiliza la AWS CLI, los parámetros `--database-installation-files-s3-bucket-name`, `--database-installation-files-s3-prefix` y `--database-installation-files` solo son necesarios para la primera versión del motor BYOM que cree para una versión y edición principales. Solo para las versiones secundarias posteriores dentro de la misma versión principal, solo `--engine` y `--engine-version` son obligatorios.

## Descripción de las versiones del motor BYOM
<a name="sqlserver-byom-creating-cev.describing"></a>

Tras crear una versión del motor BYOM, use `describe-db-engine-versions` para comprobar su estado y los detalles. El resultado devuelve dos registros para la misma versión del motor: uno para Licencia incluida (`DBEngineMediaType: None`) y otro para BYOM (`DBEngineMediaType: Customer Provided`).

**Ejemplo:**

```
aws rds describe-db-engine-versions \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --include-all \
    --output table \
    --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}"
```

**Respuesta:**

```
-----------------------------------------------------------------------
|                      DescribeDBEngineVersions                       |
+--------------+---------------------+------------+-------------------+
|    Engine    |      MediaType      |  Status    |      Version      |
+--------------+---------------------+------------+-------------------+
|  sqlserver-ee|  None               |  available |  16.00.4175.1.v1  |
|  sqlserver-ee|  Customer Provided  |  available |  16.00.4175.1.v1  |
+--------------+---------------------+------------+-------------------+
```

## Estados del ciclo de vida de la versión del motor BYOM
<a name="sqlserver-byom-creating-cev.lifecycle"></a>


| Estado | Descripción | 
| --- | --- | 
| pending-validation | RDS aceptó la solicitud y la puso en cola para su procesamiento. | 
| validating | RDS está validando el archivo multimedia RTM. | 
| creating | RDS está instalando SQL Server desde un archivo multimedia RTM. | 
| available | La versión del motor BYOM está lista para la creación de instancias. | 
| incompatible\_installation\_media | Los archivos de instalación no son válidos o están dañados. Se trata de un estado terminal. Elimine la versión del motor BYOM y vuelva a intentarlo con los archivos correctos. | 

## Modificación de una versión del motor BYOM
<a name="sqlserver-byom-creating-cev.modifying"></a>

Puede modificar una versión del motor BYOM mediante la consola de administración de AWS o AWS CLI. Puede modificar la descripción de la versión del motor BYOM o su estado de disponibilidad. La versión del motor BYOM tiene uno de los siguientes valores de estado:
+ **disponible**: puede utilizar esta versión del motor BYOM para crear una nueva instancia de base de datos o actualizar una instancia de base de datos. Este es el estado predeterminado de una versión del motor BYOM recién creada.
+ **inactiva**: no se puede crear ni actualizar una instancia de base de datos con esta versión del motor BYOM. No puede restaurar una instantánea de base de datos para crear una nueva instancia de base de datos con esta versión del motor BYOM.

Puede cambiar el estado de la versión del motor BYOM de `available` a `inactive` o de `inactive` a `available`. Puede cambiar el estado a `inactive` para evitar el uso accidental de una versión del motor BYOM o hacer que una versión de motor BYOM interrumpida elegible pueda utilizarse de nuevo.

```
aws rds modify-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --status inactive
```

**Respuesta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    ....
    "Status": "inactive",
    ....
}
```

**nota**  
Las instancias existentes que se ejecutan en una versión del motor BYOM que haya configurado como inactiva seguirán funcionando con normalidad. Solo se ven afectadas las operaciones de creación y restauración de instancias nuevas.

## Eliminación de una versión del motor BYOM
<a name="sqlserver-byom-creating-cev.deleting"></a>

Use `delete-custom-db-engine-version` para eliminar permanentemente una versión del motor BYOM. Tras la eliminación, la versión del motor vuelve a tener una sola entrada de LI única.

**Requisitos previos para la eliminación**

Antes de eliminar una versión del motor BYOM, asegúrese de lo siguiente:
+ Ninguna instancia de base de datos utiliza la versión BYOM.
+ Ninguna instantánea de base de datos hace referencia a la versión BYOM.

Si existe alguno de los recursos de RDS, la API no supera la solicitud de eliminación.

**Eliminación de una versión del motor BYOM (CLI)**

```
aws rds delete-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1
```

**Respuesta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    .....
    "Status": "deleting",
    ....
}
```

## Consideraciones
<a name="sqlserver-byom-creating-cev.considerations"></a>
+ El archivo ISO de RTM se proporciona una vez por versión principal y edición. Todas las versiones secundarias incluidas en la misma versión principal y edición reutilizarán los mismos medios de instalación.
+ Al proporcionar el RTM de SQL Server para Bring Your Own Media, solo debe utilizar la ISO RTM basada en Core y no el archivo ISO RTM basado en Server \+ CAL.

## Siguientes pasos
<a name="sqlserver-byom-creating-cev.next-steps"></a>

Cuando la versión del motor BYOM alcance el estado `available`, podrá lanzar una instancia de RDS para SQL Server utilizándola. Consulte [Creación de una instancia de base de datos de BYOM para RDS para SQL Server](sqlserver-byom-creating-instance.md).