Ativar o SSRS

Como criar o grupo de opções

1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

2. No painel de navegação, escolha Option groups (Grupos de opções).

3. Escolha Create group (Criar grupo).

4. No painel Create option group (Criar grupo de opções), faça o seguinte:

   1. Em Name (Nome), insira um nome para o grupo de opções que seja exclusivo na sua Conta da AWS, como ssrs-se-2017. O nome pode conter somente letras, números e hifens.

   2. Em Descrição, insira uma breve descrição do grupo de opções, como SSRS option group for SQL Server SE 2017. A descrição é usada para fins de exibição.

   3. Em Engine (Mecanismo), selecione sqlserver-se.

   4. Em Major engine version (Versão principal do mecanismo), selecione 14.00.

5. Escolha Criar.

Como criar o grupo de opções

• Execute um dos seguintes comandos:

Como adicionar a opção SSRS

1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

2. No painel de navegação, escolha Option groups (Grupos de opções).

3. Selecione o grupo de opções que você acabou de criar, depois escolha Add Option (Adicionar opção).

4. Em Detalhes da opção, selecione SSRS em Nome da opção.

5. Em Configurações de opção, faça o seguinte:

   1. Insira a porta de escuta do serviço SSRS. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

   2. Insira um valor em Máximo de memória.

      O Máximo de memória especifica o limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   3. Em Security groups (Grupos de segurança), selecione o grupo de segurança da VPC a ser associado à opção. Use o mesmo grupo de segurança associado à instância de banco de dados.

6. Para usar o SSRS Email para enviar relatórios, marque a caixa de seleção Configure email delivery options (Configurar opções de entrega por e-mail) em Email delivery in reporting services (Entrega por e-mail em serviços de relatórios), depois faça o seguinte:

   1. Para Sender email address (Endereço de e-mail do remetente), insira o endereço de e-mail a ser usado no campo From (De) das mensagens enviadas pelo SSRS Email.

      Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

   2. Para SMTP server (Servidor SMTP), especifique o gateway ou servidor SMTP a ser usado.

      Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

   3. Para SMTP port (Porta SMTP), insira a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

   4. Para usar a autenticação:

      1. Marque a caixa de seleção Use authentication (Usar autenticação).

      2. Para Secret Amazon Resource Name (ARN) (Nome do recurso da Amazon (ARN) do segredo), insira o ARN do AWS Secrets Manager para as credenciais do usuário.

         Use o formato a seguir:

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

         Por exemplo:

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

         Para obter mais informações sobre como criar o segredo, consulte Como usar o SSRS Email para enviar relatórios.

   5. Marque a caixa de seleção Use Secure Sockets Layer (SSL) [Usar Secure Sockets Layer (SSL)] para criptografar as mensagens de e-mail usando SSL.

7. Em Scheduling (Programação), escolha se deseja adicionar a opção imediatamente ou na próxima janela de manutenção.

8. Escolha Add option (Adicionar opção).

Como adicionar a opção SSRS

1. Crie um arquivo JSON; por exemplo, ssrs-option.json.

   1. Defina os seguintes parâmetros necessários:

      • OptionGroupName – O nome do grupo de opções que você criou ou selecionou anteriormente (ssrs-se-2017 no exemplo a seguir).

      • Port – A porta de escuta do serviço SSRS. O padrão é 8443. Para obter uma lista de valores permitidos, consulte Limitações e recomendações.

      • VpcSecurityGroupMemberships – Associações de grupos de segurança da VPC para a instância de banco de dados do RDS.

      • MAX_MEMORY – O limite superior acima do qual não são concedidas novas solicitações de alocação de memória aos aplicativos do servidor de relatório. O número é uma porcentagem da memória total da instância de banco de dados. Os valores permitidos são de 10 a 80.

   2. (Opcional) Defina os seguintes parâmetros para usar o SSRS Email:

      • SMTP_ENABLE_EMAIL: defina como true para usar o SSRS Email. O padrão é false.

      • SMTP_SENDER_EMAIL_ADDRESS: o endereço de e-mail a ser usado no campo From (De) das mensagens enviadas pelo SSRS Email. Especifique uma conta de usuário que tenha permissão para enviar e-mails do servidor SMTP.

      • SMTP_SERVER: o gateway ou servidor SMTP a ser usado. Pode ser um endereço IP, o nome NetBIOS de um computador na intranet corporativa ou um nome de domínio totalmente qualificado.

      • SMTP_PORT: a porta a ser usada para se conectar ao servidor de e-mail. O padrão é 25.

      • SMTP_USE_SSL: defina como true para criptografar as mensagens de e-mail usando SSL. O padrão é true.

      • SMTP_EMAIL_CREDENTIALS_SECRET_ARN: o ARN do Secrets Manager que contém as credenciais do usuário. Use o formato a seguir:

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

        Para obter mais informações sobre como criar o segredo, consulte Como usar o SSRS Email para enviar relatórios.

      • SMTP_USE_ANONYMOUS_AUTHENTICATION: defina como true e não inclua SMTP_EMAIL_CREDENTIALS_SECRET_ARN se não quiser usar a autenticação.

        O padrão é false quando SMTP_ENABLE_EMAIL é true.

   O exemplo a seguir inclui os parâmetros de SSRS Email usando o ARN do segredo.

   {
   "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
   }

2. Adicione a opção SSRS ao grupo de opções.

   Para Linux, macOS ou 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

Como criar uma instância de banco de dados que usa o grupo de opções

• Especifique o mesmo tipo de mecanismo de banco de dados e a versão principal que você usou ao criar o grupo de opções.

  Para Linux, macOS ou 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

Como modificar uma instância de banco de dados para usar o grupo de opções

• Execute um dos seguintes comandos:

  Para Linux, macOS ou 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