

# Activación de SSRS
<a name="SSRS.Enabling"></a>

Utilice el siguiente proceso para activar SSRS para su instancia de base de datos:

1. Cree un nuevo grupo de opciones o elija un grupo de opciones ya existente.

1. Añada la opción `SSRS` al grupo de opciones.

1. Asocie el grupo de opciones a la instancia de base de datos.

1. Permitir el acceso entrante al grupo de seguridad de la nube virtual privada (VPC) para el puerto de agente de escucha de SSRS.

## Creación de un grupo de opciones para SSRS
<a name="SSRS.OptionGroup"></a>

Para trabajar con SSRS, cree un grupo de opciones que corresponda al motor de SQL Server y la versión de la instancia de base de datos que planee utilizar. Para ello, utilice la opción Consola de administración de AWS o la AWS CLI. 

**nota**  
También puede utilizar un grupo de opciones ya existente si es para el motor y la versión correctos de SQL Server.

### Consola
<a name="SSRS.OptionGroup.Console"></a>

El siguiente procedimiento crea un grupo de opciones para SQL Server Standard Edition 2017.

**Para crear el grupo de opciones**

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 **Option groups** (Grupos de opciones).

1. Elija **Create group**.

1. En el panel **Create option group (Crear grupo de opciones)**, haga lo siguiente:

   1. En **Name** (Nombre), escriba un nombre para el grupo de opciones que sea exclusivo dentro de su Cuenta de AWS, como **ssrs-se-2017**. El nombre solo puede contener letras, dígitos y guiones.

   1. En **Descripción**, escriba una breve descripción del grupo de opciones, como **SSRS option group for SQL Server SE 2017**. La descripción se utiliza para fines de visualización.

   1. Para **Engine (Motor)**, elija **sqlserver-se**.

   1. En **Major engine version (Versión principal dle motor)**, elija **14.00**.

1. Elija **Create** (Crear).

### CLI
<a name="SSRS.OptionGroup.CLI"></a>

El siguiente procedimiento crea un grupo de opciones para SQL Server Standard Edition 2017.

**Para crear el grupo de opciones**
+ Ejecute uno de los siguientes comandos.

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

```
aws rds create-option-group \
    --option-group-name ssrs-se-2017 \
    --engine-name sqlserver-se \
    --major-engine-version 14.00 \
    --option-group-description "SSRS option group for SQL Server SE 2017"
```
Para Windows:  

```
aws rds create-option-group ^
    --option-group-name ssrs-se-2017 ^
    --engine-name sqlserver-se ^
    --major-engine-version 14.00 ^
    --option-group-description "SSRS option group for SQL Server SE 2017"
```

## Agregar la opción SSRS a su grupo de opciones
<a name="SSRS.Add"></a>

A continuación, utilice la Consola de administración de AWS o la AWS CLI para agregar la opción `SSRS` al grupo de opciones.

### Consola
<a name="SSRS.Add.CON"></a>

**Para agregar la opción SSRS**

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 **Option groups** (Grupos de opciones).

1. Elija el grupo de opciones que acaba de crear y, a continuación, elija **Add option** (Añadir opción).

1. En **Detalles de la opción**, elija **SSRS** para **Nombre de la opción**.

1. En **Configuración de opciones**, haga lo siguiente:

   1. Introduzca el puerto que debe escuchar el servicio SSRS. El valor predeterminado es 8443. Para obtener una lista de valores permitidos, consulte [Limitaciones y recomendaciones](Appendix.SQLServer.Options.SSRS.md#SSRS.Limitations).

   1. Escriba un valor en **Memoria máxima**.

      **Memoria máxima** especifica el umbral superior por encima del cual no se conceden nuevas solicitudes de asignación de memoria para las aplicaciones de servidor de informes. El número es un porcentaje de la memoria total de la instancia de base de datos. Los valores permitidos son 10–80.

   1. En **Security groups (Grupos de seguridad)**, elija el grupo de seguridad de VPC que desea asociar a la opción. Utilice el mismo grupo de seguridad asociado a su instancia de base de datos.

1. Para usar el correo electrónico de SSRS para enviar informes, seleccione la casilla de verificación **Configure email delivery options** (Configurar las opciones de entrega de correo electrónico) en**Email delivery in reporting services** (Entrega de correo electrónico en servicios de informes) y, a continuación, haga lo siguiente:

   1. En **Email address** (Dirección de correo electrónico), escriba la dirección de correo electrónico que desea usar en el campo **From** (De) de los mensajes enviados por correo electrónico de SSRS.

      Especifique una cuenta de usuario que tenga permiso para enviar correo desde el servidor SMTP.

   1. En **SMTP server** (Servidor SMTP), especifique el servidor SMTP o la puerta de enlace que se va a utilizar.

      Puede ser una dirección IP, el nombre NetBIOS de un equipo de la intranet corporativa o un nombre de dominio completo.

   1. En **SMTP port** (Puerto SMTP), introduzca el puerto que se utilizará para conectarse al servidor de correo. El valor predeterminado es 25.

   1. Para usar la autenticación:

      1. Seleccione la casilla de verificación **Use authentication** (Usar autenticación).

      1. En **Secret Amazon Resource Name (ARN)** (Nombre de recurso de Amazon [ARN]), escriba el ARN de AWS Secrets Manager para las credenciales de usuario.

         Use el siguiente formato:

         **arn:aws:secretsmanager:*Region*:*AccountId*:secret:*SecretName*-*6RandomCharacters***

         Por ejemplo:

         **arn:aws:secretsmanager:*us-west-2*:*123456789012*:secret:*MySecret-a1b2c3***

         Para obtener más información sobre la creación del secreto, consulte [Uso del correo electrónico de SSRS para enviar informes](SSRS.Email.md).

   1. Seleccione la casilla de verificación **Use Secure Sockets Layer (SSL)** (Utilizar capa de sockets seguros) para cifrar los mensajes de correo electrónico mediante SSL.

1. En **Scheduling** (Programación), elija si desea agregar la opción inmediatamente o en el siguiente período de mantenimiento.

1. Elija **Add option** (Agregar opción).

### CLI
<a name="SSRS.Add.CLI"></a>

**Para agregar la opción SSRS**

1. Cree un archivo JSON, por ejemplo `ssrs-option.json`.

   1. Defina los siguientes parámetros obligatorios:
      + `OptionGroupName`: el nombre del grupo de opciones que ha creado o elegido anteriormente (`ssrs-se-2017` en el ejemplo siguiente).
      + `Port`: el puerto donde debe escuchar el servicio SSRS. El valor predeterminado es 8443. Para obtener una lista de valores permitidos, consulte [Limitaciones y recomendaciones](Appendix.SQLServer.Options.SSRS.md#SSRS.Limitations).
      + `VpcSecurityGroupMemberships`: las suscripciones del grupo de seguridad de VPC para su instancia de base de datos de RDS.
      + `MAX_MEMORY` : el umbral superior por encima del cual no se conceden nuevas solicitudes de asignación de memoria para las aplicaciones de servidor de informes. El número es un porcentaje de la memoria total de la instancia de base de datos. Los valores permitidos son 10–80.

   1. (Opcional) Defina los siguientes parámetros para usar el correo electrónico de SSRS:
      + `SMTP_ENABLE_EMAIL`: defínalo en `true` para usar el correo electrónico de SSRS. El valor predeterminado es `false`.
      + `SMTP_SENDER_EMAIL_ADDRESS`: la dirección de correo electrónico que se va a utilizar en el campo **From** (De) de los mensajes enviados por correo electrónico de SSRS. Especifique una cuenta de usuario que tenga permiso para enviar correo desde el servidor SMTP.
      + `SMTP_SERVER`: el servidor SMTP o la puerta de enlace que se va a utilizar. Puede ser una dirección IP, el nombre NetBIOS de un equipo de la intranet corporativa o un nombre de dominio completo.
      + `SMTP_PORT`: el puerto que se va a usar para conectarse al servidor de correo. El valor predeterminado es 25.
      + `SMTP_USE_SSL`: defínalo en`true` para cifrar los mensajes de correo electrónico mediante SSL. El valor predeterminado es `true`.
      + `SMTP_EMAIL_CREDENTIALS_SECRET_ARN`: el ARN de Secrets Manager que contiene las credenciales de usuario. Use el siguiente formato:

        **arn:aws:secretsmanager:*Region*:*AccountId*:secret:*SecretName*-*6RandomCharacters***

        Para obtener más información sobre la creación del secreto, consulte [Uso del correo electrónico de SSRS para enviar informes](SSRS.Email.md).
      + `SMTP_USE_ANONYMOUS_AUTHENTICATION`: defínalo en `true` y no incluya `SMTP_EMAIL_CREDENTIALS_SECRET_ARN` si no quiere usar la autenticación.

        El valor predeterminado es `false` cuando `SMTP_ENABLE_EMAIL` es `true`.

   El siguiente ejemplo incluye los parámetros de correo electrónico de SSRS, que utilizan el ARN secreto.

   ```
   {
   "OptionGroupName": "ssrs-se-2017",
   "OptionsToInclude": [
   	{
   	"OptionName": "SSRS",
   	"Port": 8443,
   	"VpcSecurityGroupMemberships": ["sg-0abcdef123"],
   	"OptionSettings": [
               {"Name": "MAX_MEMORY","Value": "60"},
               {"Name": "SMTP_ENABLE_EMAIL","Value": "true"}
               {"Name": "SMTP_SENDER_EMAIL_ADDRESS","Value": "nobody@example.com"},
               {"Name": "SMTP_SERVER","Value": "email-smtp.us-west-2.amazonaws.com"},
               {"Name": "SMTP_PORT","Value": "25"},
               {"Name": "SMTP_USE_SSL","Value": "true"},
               {"Name": "SMTP_EMAIL_CREDENTIALS_SECRET_ARN","Value": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MySecret-a1b2c3"}
               ]
   	}],
   "ApplyImmediately": true
   }
   ```

1. Agregue la opción `SSRS` al grupo de opciones.  
**Example**  

   Para Linux, macOS o Unix:

   ```
   aws rds add-option-to-option-group \
       --cli-input-json file://ssrs-option.json \
       --apply-immediately
   ```

   Para Windows:

   ```
   aws rds add-option-to-option-group ^
       --cli-input-json file://ssrs-option.json ^
       --apply-immediately
   ```

## Asociación de un grupo de opciones a su instancia de base de datos
<a name="SSRS.Apply"></a>

Puede utilizar la Consola de administración de AWS o la AWS CLI para asociar el grupo de opciones a la instancia de base de datos.

Si usa una instancia de base de datos existente, debe tener ya asociados un dominio de Active Directory y un rol de AWS Identity and Access Management (IAM). Si crea una instancia nueva, especifique un rol de IAM y un dominio de Active Directory ya existentes. Para obtener más información, consulte [Uso de Active Directory con RDS para SQL Server](User.SQLServer.ActiveDirectoryWindowsAuth.md).

### Consola
<a name="SSRS.Apply.Console"></a>

Puede asociar su grupo de opciones a una instancia de base de datos nueva o ya existente:
+ Para una nueva instancia de base de datos, asocie el grupo de opciones al lanzar la instancia. Para obtener más información, consulte [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md).
+ Para una instancia de base de datos existente, modifique la instancia y asóciele el nuevo grupo de opciones. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md).

### CLI
<a name="SSRS.Apply.CLI"></a>

Puede asociar su grupo de opciones a una instancia de base de datos nueva o ya existente.

**Para crear una instancia de base de datos que utilice el grupo de opciones**
+ Especifique el mismo tipo de motor de base de datos y la misma versión principal que ha utilizado al crear el grupo de opciones.  
**Example**  

  Para Linux, macOS o Unix:

  ```
  aws rds create-db-instance \
      --db-instance-identifier myssrsinstance \
      --db-instance-class db.m5.2xlarge \
      --engine sqlserver-se \
      --engine-version 14.00.3223.3.v1 \
      --allocated-storage 100 \
      --manage-master-user-password  \
      --master-username admin \
      --storage-type gp2 \
      --license-model li \
      --domain-iam-role-name my-directory-iam-role \
      --domain my-domain-id \
      --option-group-name ssrs-se-2017
  ```

  Para Windows:

  ```
  aws rds create-db-instance ^
      --db-instance-identifier myssrsinstance ^
      --db-instance-class db.m5.2xlarge ^
      --engine sqlserver-se ^
      --engine-version 14.00.3223.3.v1 ^
      --allocated-storage 100 ^
      --manage-master-user-password ^
      --master-username admin ^
      --storage-type gp2 ^
      --license-model li ^
      --domain-iam-role-name my-directory-iam-role ^
      --domain my-domain-id ^
      --option-group-name ssrs-se-2017
  ```

**Para modificar una instancia de base de datos para utilizar su grupo de opciones**
+ Ejecute uno de los siguientes comandos.  
**Example**  

  Para Linux, macOS o Unix:

  ```
  aws rds modify-db-instance \
      --db-instance-identifier myssrsinstance \
      --option-group-name ssrs-se-2017 \
      --apply-immediately
  ```

  Para Windows:

  ```
  aws rds modify-db-instance ^
      --db-instance-identifier myssrsinstance ^
      --option-group-name ssrs-se-2017 ^
      --apply-immediately
  ```

## Permitir el acceso de entrada a su grupo de seguridad de VPC
<a name="SSRS.Inbound"></a>

Para permitir el acceso entrante al grupo de seguridad de la VPC asociado a su instancia de base de datos, cree una regla de entrada para el puerto de agente de escucha de SSRS especificado. Para obtener más información acerca de la configuración de grupos de seguridad, consulte [Proporcionar acceso a la instancia de base de datos en la VPC mediante la creación de un grupo de seguridad](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup).