Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:


       

Índice
exclude.*ndice:

Requisitos de software para instalação do T-Reports


1) Sistema Operacional:

Informações

Windows 7 ou 10 ou Server 2012 (ou superior)

2) Banco de Dados:

Informações

SQL Server 2014 (ou superior)

ou

Oracle 11 (ou superior).

3) - IIS configurado na máquina (instalação padrão).

4) - Instale a versão do .Net Framework 4.7.1

Informações

Disponível em "https://www.microsoft.com/pt-br/download/details.aspx?id=56116"

5) - Instale a última versão do sdk do .Net core (a versão runtime 2.1 ou superior

Informações

Versão 64 bits "https://download.microsoft.com/download/3/7/1/37189942-C91D-46E9-907B-CF2B2DE584C7/dotnet-sdk-2.1.200-win-x64.exe"

Versão 32 bits "https://download.microsoft.com/download/3/7/1/37189942-C91D-46E9-907B-CF2B2DE584C7/dotnet-sdk-2.1.200-win-x86.exe"

6) - Instale a última versão do DotNetCore.2.1.2.RC2-WindowsHosting

Informações

Disponível em "http://go.microsoft.com/fwlink/?LinkId=798480"


Configuração do RAC


É necessário configurar o RAC para garantir a segurança do T-Reports. Ele será responsável por validar os acessos á página.

Portanto, vamos rodar o processo de "Migrator" para criação do banco de dados do RAC. Para isso, basta seguir os passos abaixo:

    a) - Descompacte o arquivo "TnfRac.zip" dentro do diretório "c:\TReports\Rac";

    b) - Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Migrator" e efetue as seguintes modificações:

       b.1) - No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:

             "ConnectionStrings": {

               "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TnfRac; User Id=sa;password=xxxx"

              },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC.

Como sugestão informe o usuário e senha do "sa".

Informações

Nesse passo, o banco de dados a ser criado, no caso o banco "TnfRac" não poderá existir no servidor "BHD050100275".

Caso exista, apague o banco atual e recrie com as novas configurações.

       c) - No atributo "Clients" crie configurações para informar a máquina (ou as máquinas) que hospedarão o Front-end do TReports: 

         c.1) - No Atributo "ClientId" deverá ser informado um identificador único que será usando nas configurações dos BackEnds e FrontEnds;

         c.2) - No atributo "AccessTokenLifetime" informe o tempo de expiração de um accessToque;

Dica

Deve ser o tempo (em segundos) até que o login precise ser renovado.

         c.3) - No atributo "RedirectUris" informe os endereços que serão usados pelo retorno do Rac:

Dica

Retorno de callback após o login e renovação do accessToken após expiração.

Exemplos:

"http://localhost:7017/auth-callback.html", - endereço usado para realizar o login

"http://localhost:7017/auth-callback", - endereço usado para realizar o login

"http://localhost:7017/assets/silent-renew.html", - endereço usado na renovação do login

"http://localhost:7017/assets/silent-renew" - endereço usado na renovação do login

         c.4) -  No atributo "PostLogountRedirectUris" informe os endereços usados pelo Rac após o logout;

         c.5) - Nos outros atributos mantenham os valores defaults;                


Expandir
titleExemplo "ClientId = js_oidc"

Nessa configuração, foram informados endereços da máquina localHost e porta 7017.

Isso significa que o rac aceitará somente solicitações provenientes do endereço "http://localhost:7017";

 "Clients": [

                                   {

                                     "ClientId": "js_oidc",

                                     "ClientName": "JavaScript OIDC Client For Testing",

                                     "AllowedGrantTypes": [ "hybrid", "client_credentials" ],

                                     "RequireConsent": false,

                                     "AllowAccessTokensViaBrowser": "true",

                                     "AllowOfflineAccess": true,

                                     "AccessTokenLifetime": 300, // 5min em segundos

                                     "IdentityTokenLifetime": 250,

                                     "RedirectUris": [

                                       "http://localhost:7017/auth-callback.html",

                                       "http://localhost:7017/auth-callback",

                                       "http://localhost:7017/assets/silent-renew.html",

                                       "http://localhost:7017/assets/silent-renew"

                                     ],

                                     "PostLogoutRedirectUris": [ "http://localhost:7017/" ],

                                     "AllowedCorsOrigins": [ "http://localhost:7017" ],

                                     "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256()

                                     "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ]

                                   }]

Expandir
titleExemplo "ClientId = js_oidc_2777"

 Nessa configuração, foram informados endereços da máquina BHN050102777 e porta 7017.

Isso significa que o RAC aceitará somente solicitações provenientes do endereço "http://BHN050102777:7017";

Nesse caso o FrontEnd do Reports deve ser instalado em configurado na máquina BHN050102777.

                                "Clients": [

                                   {

                                     "ClientId": "js_oidc_bhd050100275",

                                     "ClientName": "JavaScript OIDC Client For Testing",

                                     "AllowedGrantTypes": [ "hybrid", "client_credentials" ],

                                     "RequireConsent": false,

                                     "AllowAccessTokensViaBrowser": "true",

                                     "AllowOfflineAccess": true,

                                     "AccessTokenLifetime": 300, // 5min em segundos

                                     "IdentityTokenLifetime": 250,

                                     "RedirectUris": [

                                       "http://bhd050100275:7017/auth-callback.html",

                                       "http://bhd050100275:7017/auth-callback",

                                       "http://bhd050100275:7017/assets/silent-renew.html",

                                       "http://bhd050100275:7017/assets/silent-renew"

                                     ],

                                     "PostLogoutRedirectUris": [ "http://bhd050100275:7017/" ],

                                     "AllowedCorsOrigins": [ "http://bhd050100275:7017" ],

                                     "ClientSecrets": [ { "Value": "K7gNU3sdo+OL0wNhqoVWhr3g6s1xYv72ol/pe/Unols=" } ], // Calculado com IdentityServer4.Models.HashExtensions.Sha256()

                                     "AllowedScopes": [ "openid", "profile", "email", "authorization_api", "backend_api" ]

                                   }]


    

    d) - Entre no comand prompt do windows e acesse o diretório "c:/TReports/Rac/Migrator";

    e) - Execute o comando "dotnet Tnf.Rac.EntityFrameworkCore.Migrator.dll";

        Obs: Esse comando rodará a ferramenta de criaçaõ automática do banco de dados do Rac.

Dica

Caso a mensagem "Continue to migration for this host database? (Y/N):" apareça, digite "Y" para concluir.

Expandir
titleExemplo

   f) - Após rodar o comando, verifique se o banco de dados foi criado no servidor de banco de dados;

         

Agora, vamos configurar o Host do Rac, para isso basta seguir os passos abaixo:

     a) - Descompacte o arquivo "HostRac.zip" dentro do diretório "c:\TReports\Rac\Host";

Abra o arquivo "appsettings.json" do diretório "c:\TReports\Rac\Host" e efetue as seguintes modificações:

       - No atributo "ConnectionStrings" informe a string de conexão conforme exemplo abaixo:

          "ConnectionStrings": {

             "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TnfRac; User Id=sa;password=xxxx"

          },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados do RAC.

Como sugestão informe o usuário e senha do "sa".

Informações

Essa string de conexão deve ser a mesma usada no passo anterior "Criação do banco de dados do RAC"

      b) - Entre no diretório "TReports/Rac/Host" e abra o arquivo "hosting";

             - Informe no atributo "urls" a string: "http://*:5000" (essa configuração identificará a porta de hospedagem do RAC);

Configuração do T-ReportsBackEnd


       1) - Descompacte o arquivo BackEnd.zip dentro do diretório "c:\TReports\BackEnd";

       2) - Abra o arquivo "appsettings.json" e efetue as seguintes modificações:

       a) - No atributo "ConnectionStrings" informe a string de conexão contendo a localização do banco de dados do repositório do T-Reports:

             "ConnectionStrings": {

               "Default": "Server=BHD050100275; TrustServerCertificate=True; database=TReportsDB; User Id=sa;password=xxxx"

             },

Dica

O usuário e senha do banco precisará de permissão para criação de banco de dados de repositório do TReports

Como sugestão informe o usuário e senha do "sa".

          Atualmente somente o SqlServer poderá ser usando como repositório do T-Reports;

Informações

Se o banco de dados "TReportsDB" não existir, ao hospedar o backEnd esse banco será criado automaticamente;

      b) - No atributo "BackgroudJobSettings", no parêmetro "DelayTime", informe a quantidade em "minutos" para leitura da tabela de "agendamento de execução de jobs" (default será 1 minuto). Mantenham os valores defaults para os outros parâmetros; 

3) - Abra o arquivo "Hosting.json" e informe o endereço "urls": "http://*:4999" de hospedagem do backEnd;

4) - Abra o arquivo "racsettings.json" e no atributo "AuthorityEndpoint" informe o endereço de hospedagem do rac, conforme exemplo abaixo:

                {             

                  "AuthorityEndpoint": "http://localhost:5000/",

                  "ApiName": "backend_api",

                  "RequireHttpsMetadata": false,

                  "CacheAuthentications": false,

                  "CacheAuthenticationDuration": 10

                }

Configuração do T-ReportsFrontEnd


1) - Descompacte o arquivo FrontEnd.zip dentro do diretório "c:\TReports\FrontEnd";

2) - No diretório "c:\TReports\FrontEnd\config", abra o arquivo "appsettings.js" e efetue as seguintes modificações:

       a)       Informe no atributo "apiHost' o endereço base de hospedagem Backend na porta 4999;

Exemplo: 'http://localhost:4999/'

       b)       Informe o tenant da aplicação;

Exemplo: tenant: 'poa'

       c)       Informe no atributo "authority" o endereço de hospedagem do RAC definido na Configuração do Host do RAC acima.

Exemplo: 'http://localhost:5000/'

       d)       Informe o identificador do client criado no passo "c.1" da Configuração do RAC.

Exemplo: client_id: 'js_oidc';  


Dica

Tudo certo!

Agora só falta configurar os tipos de hospedagem. Para isso, basta acessar a página: Tipos de hospedagem.


http://go.microsoft.com/fwlink/?LinkId=798480 

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.01.XX

Informações
iconfalse

Processo: Configuração Ambiente

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 09/05/2018

Informações
iconfalse

Autores:

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOA

Wesley Avelino De Carvalho