Versões comparadas

Chave

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

Índice:


       

Índice
exclude.*ndice:

Passo a passo da instalação


A seguir será apresentado a passo a passo para instalação do TReports.

Clique aqui para fazer o Dowload do TReports.


Deck of Cards
idFonte de Dados
Card
id1
label1° Passo

Antes de iniciar a instalação do TReports, faça uma validação nas orientações acerca dos requisitos de software e configurações de ambiente para a utilização do TReports.

Disponível em:  Portabilidade TReports 


Card
id2
label2° Passo

É necessário aceitar os termos de contrato antes de prosseguir com a instalação.

Card
id3
label3° Passo

É necessário informar o diretório onde o TReports será instalado.

Card
id4
label4° Passo

É necessário selecionar os componentes a serem instalados.

Instalação completa do TReports e do RAC: O TReports e o RAC serão instalados na máquina e não será necessário realizar nenhuma configuração adicional.

Instalar somente o TReports e utilizar um RAC existente: Como o TReports é dependente do RAC para funcionar, é necessário que exista um RAC instalado na máquina ou em outra, que deve ser informado nas próximas telas. Além disso, é necessário ter cadastrado no RAC, um tenant, produto e client com as URLs de redirecionamento apontando corretamente para o TReports.

Instalar somente o RAC: Somente o RAC será instalado na máquina, com as configurações corretas para futura integração com o TReports.

Dica

Recomendamos a instalação completa do TReports e RAC

Card
id5
label5° Passo

Configurações do TReports:


Porta: Defina em qual porta o TReports irá subir.

Tenant: Defina um Tenant para o TReports.

Aviso

O Tenant não pode conter espaços, pontos ou caracteres especiais.

URL Externa: Defina a URL externa onde o TReports será chamado.

Aviso

Com a opção de URL Externa marcada, deve ser utilizado o DNS ou Hostname do servidor. O acesso à aplicação não deve ser realizado utilizando endereço IP.


Card
id6
label6° Passo

Defina qual o tipo de banco de dados será utilizado para o TReports.


Card
id7
label7° Passo

Configurações da conexão com o banco de dados que irá hospedar as informações do TReports.


Servidor: Informe o nome da máquina ou IP.

Aviso

Caso o Servidor de Banco de Dados esteja configurado em uma porta diferente da padrão é necessário informar a porta como no exemplo abaixo:

SQL: Nome_servidor,1435

Nome ou Instância: Para SQLServer é necessário informar um nome para a base, que será criada com o nome escolhido.

Usuário: Usuário com permissão para criar bases de dados.

Senha: Informe a senha.

Card
id8
label8° Passo

Para a geração de relatórios é necessário configurar um Servidor de Licenças válido. Dessa forma, informe o IP e porta de seu Servidor de Licenças mais o CNPJ (somente números) da instituição.

Caso sua instituição não seja Brasileira, o CNPJ pode ser deixado em branco, seu preenchimento é opcional.

Essas informações podem ser alteradas futuramente na tela de "Configurações" do TReports.

Aviso
iconfalse

Na versão 12.1.29, patch 198, o preenchimento CNPJ passa a ser opcional, apenas para instituições estrangeiras e que não possuem este registro em seu país.

A partir da 12.1.28 será necessário informar o CNPJ no momento da instalação. Em casos onde a instituição possua múltiplos CNPJ’s sugerimos utilizar o que possua licenças corporativas.

Card
id9
label9° Passo

Defina qual o tipo de banco de dados será utilizado para o TRac.


Card
id10
label10° Passo

Configurações da conexão com o banco de dados que irá hospedar as informações do RAC.


Servidor: Informe o nome da máquina ou IP.

Aviso

Caso o Servidor de Banco de Dados esteja configurado em uma porta diferente da padrão é necessário informar a porta como no exemplo abaixo:

SQL: Nome_servidor,1435

Nome ou Instância: Para SQLServer é necessário informar um nome para a base, que será criada com o nome escolhido.

Usuário: Usuário com permissão para criar bases de dados.

Senha: Informe a senha.

Card
id11
label11° Passo

Certifique-se que as informações estão corretas e prossiga com a instalação.

Ao final, clique em concluir para que o TReports e o RAC sejam abertos no seu navegador para as futuras configurações.

Card
id12
label12° Passo

Certifique-se que o banco de dados do RAC e do TReports foram criados corretamente em seu banco de dados (a base do TReports será criada automaticamente após seu primeiro acesso em seu navegador).

Certifique-se também que os aplicativos no IIS foram criados corretamente no Default Web Site. Para acessar os mesmos, basta clicar em "Procurar", a direita da tela.


Atualizações:


A seguir será demonstrado como proceder com a atualização do TReports, para diferentes versões e patches.

Deck of Cards
idpatch
Card
labelAtualização de Versão

Para prosseguir com a atualização de versão, será necessário remover a versão anterior do TReports instalada.

Dica

Não é necessário fazer qualquer tipo de alteração no banco de dados usado. Para atualizações use as mesmas informações do banco de dados usado na primeira instalação.

Deck of Cards
idatualizaversao
Card
labelDiretório

Na etapa de seleção de diretório para instalação, não é necessário informar o mesmo diretório da instalação anterior do TReports.

Card
labelTReports/RAC

Para que os dados das bases RAC e TReports sejam migrados corretamente para a nova versão da aplicação, é recomendado prosseguir com a instalação do TReports e do RAC.

Card
labelConfigurações da URL do TReports

Informe as configurações de Porta, Tenant e URL externa para o TReports, as configurações podem ser diferentes das usadas na instalação anterior, o que for definido na instalação atual será definitivo.


Detalhe das configurações no 5º passo descrito na instalação.

Card
labelBanco de Dados TReports

Para a migração de dados para a nova versão do TReports, devem ser preenchidos os mesmos dados do banco usado anteriormente.

Card
labelLicense Server

As informações do License podem ser diferentes das configurações usadas na instalação anterior. As informações preenchidas poderão ser alteradas futuramente na tela de Configurações do TReports.

Detalhe das configurações no 8º passo descrito na instalação.

Card
labelBanco de Dados RAC

Para a migração de dados para a nova versão do TReports, devem ser preenchidos os mesmos dados do banco RAC usado anteriormente.

Card
labelFinalização

Certifique-se que as informações estão corretas e prossiga com a instalação.

Ao final, clique em concluir para que o TReports e o RAC sejam abertos no seu navegador.

Card
labelAtualização de Patch

Com a versão cheia do TReports instalada, inicie o executável do patch.

Não será necessário informar o local de destino para atualização, uma vez que o diretório de instalação é automaticamente identificado.

Clique em instalar para que o processo de atualização do TReports seja iniciado.

Dica

Após a atualização, o instalador será fechado automaticamente, indicando que a atualização ocorreu com sucesso.

Nota
titlePara patches posteriores ao 12.1.29.261


Devido à uma atualização de segurança do RAC, para os patches posteriores ao 12.1.29.261 é necessário, após a atualização, rodar o migrador de base de dados. Este procedimento só é necessário uma única vez ao atualizar de versões anteriores ao patch mencionado anteriormente.


Deck of Cards
idMigrator
Card
id12
labelPasso-a-Passo

Acesse em seu Windows Explorer a pasta de instalação do TReports e entre na pasta 'totvs.rac'.

Dentro dela encontre o arquivo 'appsettings.migrator.json' e confira se as informações de 'ConnectionString' estão conforme o configurado na instalação (10º Passo da instalação).

Bloco de código
titleConfiguração para conferir
collapsetrue
    "ConnectionStrings": 

	{
        "SqlServer": "...",
        "Oracle": "..."
    },

Em seguida, encontre o executável chamado 'Tnf.Rac.EntityFrameworkCore.Migrator.exe'

Abrirá uma janela no console para iniciar a migração, então digite 'Y' e o processo será iniciado.

Feito isso, reinicie o aplicativo do RAC no IIS.

Aviso

Não é possível instalar um patch de uma versão diferente. Por exemplo, caso a versão 12.1.28 esteja instalada, não é possível seguir com a atualização de patch para a versão 12.1.29.130.


Configuração do RAC:


A seguir será apresentado a passo a passo para configuração do RAC, responsável pela segurança do TReports.

Deck of Cards
idFonte de Dados
Card
id11
label1° Passo

Acesse em seu navegador o endereço do TReports (ex: localhost/TReports).

Ele será redirecionado automaticamente para a tela do RAC, pedindo usuário e senha.

Utilize o usuário "admin" e senha "totvs@123" para entrar.

Aviso
titleUsuário admin

Após o primeiro acesso, lembre-se de trocar a senha do usuário "admin".


Card
id12
label2° Passo

Note que o login é efetuado com sucesso, porém nenhuma tela é exibida no TReports.

Para isso, é necessário configurar as permissões de usuário e perfil no RAC.

Acesse em seu navegador o endereço do RAC (ex: localhost/totvs.rac)

Utilize o tenant "treports", usuário "admin" e senha "totvs@123" para entrar.

Card
id13
label3° Passo

Note que o login é efetuado com sucesso no Gerenciamento do RAC.

Acesse a tela de Perfis e inclua um novo perfil com as permissões desejadas do TReports, referentes ao acesso a cada uma das telas:



Card
id14
label4° Passo

Em seguida, acesse a tela de Usuários e edite o usuário admin, vinculando-o ao perfil criado, ou inclua um novo usuário e selecione quais serão os perfis vinculados a ele.

Card
id15
label5° Passo

Em seguida, acesse o TReports com o usuário cadastrado e note que as telas aparecerão conforme permissão do usuário logado!

Erros comuns:


Caso esse erro ocorra, sugerimos entrar na pasta totvs.rac\InstallLog e abrir o arquivo "MigratorErrorLog".

No arquivo conterá mais informações sobre o tipo de erro ocorrido e será mais fácil identificar a correta solução.

Dica

Certifique-se que o usuário tem permissão para criar tabelas no Banco de Dados.

Certifique-se que a máquina está comunicando corretamente com o Servidor de Banco de Dados.

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.1.22 ou superior

Informações
iconfalse

Processo: Instalação TReports

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Aline Cristina Braz de Oliveira

Carlos Philippe de Farias Marques

Diogo Damiani Ferreira

Gustavo Naves De Castro

TIAGO ANDRADE GOMES SILVEIRA

Wesley Avelino De Carvalho