Í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.


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 


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

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

É 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.

Recomendamos a instalação completa do TReports e RAC

Configurações do TReports:


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

Tenant: Defina um Tenant para o TReports.

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

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

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.


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


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.

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.

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.

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

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.

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


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.

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.

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.

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.


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

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.

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.

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.

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.

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

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.

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

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.

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.

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

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.

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.

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.

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:



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.

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.

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.

Produto: Framework

Versão: 12.1.22 ou superior

Processo: Instalação TReports

Status: Finalizado

Data:  

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