--- title: Criando um ambiente de homologação source: https://tdn.totvs.com/pages/viewpage.action?pageId=269439292 path: \Plataforma Documentação técnica\Instalação e Atualização\Criando um ambiente de homologação.md --- - [Objetivo](#Criandoumambientedehomologação-Objetivo) - [Pré-requisitos](#Criandoumambientedehomologação-Pré-requisitos) - [Fazer uma nova instalação](#Criandoumambientedehomologação-Fazerumanovainstalação) - [Configurar a plataforma](#Criandoumambientedehomologação-Configuraraplataforma) - [Acessar o Painel de controle](#Criandoumambientedehomologação-AcessaroPaineldecontrole) - [Ajustar endereço de acesso](#Criandoumambientedehomologação-Ajustarendereçodeacesso) - [Ajustar caminho do volume](#Criandoumambientedehomologação-Ajustarcaminhodovolume) - [Configurar Fluig Analytics](#Criandoumambientedehomologação-ConfigurarFluigAnalytics) - [Verificar parâmetros](#Criandoumambientedehomologação-Verificarparâmetros) - [Configurar TOTVS Identity](#Criandoumambientedehomologação-ConfigurarTOTVSIdentity) - [Configurar autenticação integrada](#Criandoumambientedehomologação-Configurarautenticaçãointegrada) - [Copiar os widgets personalizados](#Criandoumambientedehomologação-Copiaroswidgetspersonalizados) - [OAuth Providers](#Criandoumambientedehomologação-OAuthProviders) - [Serviços](#Criandoumambientedehomologação-Serviços) - [Reiniciar o Fluig](#Criandoumambientedehomologação-ReiniciaroFluig) # Objetivo --- O objetivo deste guia é orientar administradores e desenvolvedores na preparação de um ambiente de homologação que seja fiel ao ambiente de produção utilizado pelos usuários da plataforma. Dessa forma, ao testar novas atualizações ou desenvolvimentos, é possível simular o comportamento da plataforma, diminuindo a chance de imprevistos, perda de dados e instabilidades no ambiente de produção. **oculto** **Observação interna: Esse procedimento foi repassado para o artigo ** **Caso tenha alguma atualização aqui, lembrar de repassar pra lá.** # Pré-requisitos --- - Um servidor separado do ambiente de produção e que preencha os requisitos da [Matriz de Portabilidade](../Especificações Técnicas/Matriz de Portabilidade.md) e [Dimensionamento](../Especificações Técnicas/Dimensionamento.md). - Cópia da base de dados do Fluig em produção. Importante! O gerenciamento do banco de dados é de responsabilidade do cliente. Acione sua equipe interna de TI para obter a cópia da base de dados. - Cópia do(s) [volume(s)](http://tdn.totvs.com/pages/viewpage.action?pageId=233766796) do Fluig em produção. - Cópia da [pasta de instalação](http://tdn.totvs.com/x/b0sxE) do Fluig em produção (incluindo os *kits* e *widgets* personalizados na pasta appserver/apps). # Fazer uma nova instalação --- - Faça o *download* do pacote de instalação do Fluig no [Central do cliente](https://suporte.totvs.com/portal/p/10098/download#000035). Esse pacote deve estar na mesma atualização da base de dados copiada, ou seja, se o ambiente de produção estiver na **Update  1.6.5-190326**, a instalação no ambiente de homologação deve ser feita com essa mesma *release*.  Atenção! Caso você não tenha o pacote de instalação de mídias anteriores necessário para instalação, ficará de responsabilidade de cliente o processo de atualização da plataforma. Disponibilizaremos somente os pacotes de releases atuais no Portal de cliente para download. - Execute o *wizard* de instalação, conforme a documentação ([Windows](Guia de instalação da plataforma/Instalação da plataforma em Windows - Instalador.md) / [Linux](Guia de instalação da plataforma/Instalação da plataforma no Linux - Instalador.md)), mas fique atento no momento de configurar o banco de dados para informar corretamente os dados de acesso **da cópia** da base de produção e não da base original. O mesmo é valido para o serviço de cache, que não deve ser compartilhado. ![](..\..\images\banco_de_dados.png) - Verifique também o número de licenças disponíveis no servidor de licenças, pois cada usuário ativo no ambiente de homologação consumirá uma licença. - Após concluir a instalação, inicie os serviços do Fluig. # Configurar a plataforma --- Uma vez instalado o Fluig no ambiente de homologação, é necessário ajustar os dados da base copiada da produção com os dados do novo ambiente. ## Acessar o Painel de controle --- - Acesse o Fluig no endereço que foi configurado durante a nova instalação e autentique-se com o administrador da plataforma (wcmadmin). É provável que ocorram redirecionamentos para o endereço de produção, visto que a base de dados ainda está configurada com estas informações. Se isso ocorrer, cole a URL de homologação novamente na barra de endereços do navegador. Nota: Caso esteja integrado ao TOTVS Identity, verifique [nessa documentação](https://tdn.totvs.com/pages/viewpage.action?pageId=203767554) como acessar a plataforma com o usuário wcmadmin. - Para acessar o Painel de Controle do wcmadmin, informe http://[fluig\_homologacao]/portal/p/wcm/cpaneladmin na barra de endereços do navegador. ## Ajustar endereço de acesso --- Para ajustar o endereço de acesso, siga os passos da documentação [ARQ - Como alterar a URL de acesso do Fluig?](https://centraldeatendimento.totvs.com/hc/pt-br/articles/27663603084567-Fluig-Plataforma-CON-Como-alterar-a-URL-de-acesso-a-plataforma) ## Ajustar caminho do volume --- Os volumes são utilizados pelo Fluig para armazenar os documentos, artigos, formulários, *templates* e demais arquivos publicados na plataforma. O(s) volume(s) copiados do servidor de produção para o de homologação precisam ser configurados no Painel de Controle para que a nova instalação do Fluig possa localizá-los. - Crie uma nova pasta vazia no sistema operacional do servidor de homologação. - Acesse o Painel de Controle do wcmadmin e selecione a opção **Volumes**. - Selecione o volume que deseja ajustar e clique em **Editar**. - No campo **Diretório Físico**, informe o caminho completo da pasta criada, inclusive com o nome do diretório e salve a alteração. - Copie os arquivos salvos dentro do volume copiado do ambiente de produção para a nova pasta informada como volume no Fluig. ![](..\..\images\Image%207%20(1).png) Fique por dentro! Para visualizar mais detalhes e informações, acesse nossa documentação sobre [Plataforma ❙ Volumes (wcmadmin)](https://tdn.totvs.com/pages/viewpage.action?pageId=233766796). ## Configurar Fluig Analytics --- Levando em consideração que o banco de dados replicado veio com as informações de integração do ambiente de produção é muito importante que seja alterada para o projeto de homologação ou desabilitada neste momento, pois o envio de dados configurado com o projeto de produção no ambiente de homologação irá sobrescrever as informações do ambiente de produção causando conflito. Lembrando que o Fluig permite integrar apenas uma empresa (*tenant*) por projeto no Fluig Analytics, portanto caso você ainda não possua um projeto de homologação, é preciso solicitar via ticket para o atendimento Fluig a criação deste projeto. Siga os passos descritos na página [Guia de Implantação fluig Analytics](../Recurso de Analytics/Guia de Implantação do Analytics.md) para solicitar o projeto e habilitar a integração. ## Verificar parâmetros --- Acesse o menu **Painel de Controle** e o recurso **Configuração do sistema**. Na aba **Parâmetros** da plataforma verifique as informações em todos campos. Altere o que for necessário, de acordo com o novo servidor do Fluig. Fique por dentro! Para visualizar mais detalhes e informações, acesse nossa documentação sobre [Configurações do sistema](https://tdn.totvs.com/pages/viewpage.action?pageId=235597328). ## Configurar TOTVS Identity --- Levando em consideração que o banco de dados replicado veio com a integração habilitada ou mesmo, que se queira habilitar a integração com o TOTVS Identity homologação, será necessário atualizar ou incluir as informações de integração neste momento. Para isso, é imprescindível ter as informações do [contexto de homologação](https://tdn.totvs.com/pages/viewpage.action?pageId=181144752) do TOTVS Identity para posteriormente seguir os passos descritos na página [Integração do Fluig com o Identity](../Configuração/Identity/Integração da plataforma com o Identity.md). ## Configurar autenticação integrada --- Criando o ambiente de homologação usando a replicação do banco de dados da aplicação de produção, as informações da tela de Autenticação Integrada da plataforma estarão preenchidas, portanto será necessário ajustá-las realizando uma nova configuração da autenticação integrada para o ambiente de homologação. Siga os procedimentos informados na página [Configurando Autenticação Integrada](../Configuração/Configuração de Ambiente/Configurando Autenticação Integrada.md). Recomendamos que seja gerado um novo Token de autenticação. Além disso, é preciso criar um novo arquivo 'remote\_auth.asp' e salvá-lo em um novo diretório do IIS, porém, não é necessário reconfigurar o(s) navegador(es). ## Copiar os *widgets* personalizados --- Caso faça uso de *kits* ou *widgets* personalizados no ambiente de produção, é necessário copiá-los manualmente para a pasta [instalação\_fluig]/appserver/apps no ambiente de homologação. Importante! Copie apenas os *widgets* personalizados ou adquiridos via Fluig Store. Os demais *widgets* são padrão do Fluig e estarão na nova instalação automaticamente. # OAuth Providers --- Caso possua integrações REST configuradas em seu ambiente de produção através do cadastro OAuth Provider e OAuth App, é necessário editar e revisar os apontamentos de URL de todos os OAuth Provider cadastrados em seu novo ambiente de homologação. Para realizar esta análise é preciso estar logado com um usuário **administrador**. Acesse o menu **Painel de Controle**, localize o agrupador **Parâmetros técnicos** e acione o recurso **OAuth Provider**. ![](..\..\images\OAuth%20165.png) Fique por dentro! Para visualizar mais detalhes e informações, acesse nossa documentação sobre [Plataforma ❙ OAuth provider](https://tdn.totvs.com/pages/viewpage.action?pageId=234455787). # Serviços --- As integrações JDBC e REST cadastradas em seu ambiente através do ícone Serviços devem ter suas URL de apontamentos revisadas. As integrações SOAP cadastradas como serviços em seu ambiente são mais sensíveis a mudanças como esta, pois além do cadastro no banco também têm alguns arquivos que são gerados no servidor. Portanto, caso a URL dos serviços SOAP de homologação sejam diferentes das de produção, as mesmas devem ser **excluídas e recadastradas**. Para realizar estas verificações é preciso estar logado com um usuário administrador. Acesse o menu **Painel de Controle**, localize o agrupador **Desenvolvimento** e acione o recurso **Serviços**. ![](..\..\images\Painel%20de%20Controle%20165.png) Fique por dentro! Para visualizar mais detalhes e informações, acesse nossa documentação sobre [Serviços](https://tdn.totvs.com/pages/viewpage.action?pageId=243660796). # Reiniciar o Fluig --- Uma vez concluídos todos os passos acima, para que as alterações sejam aplicadas, reinicie os serviços do Fluig na seguinte ordem : 1º fluig\_Indexer, 2º fluig\_RealTime, 3º fluig. Quando a plataforma estiver no ar, pode-se usar os mesmos logins e senhas do ambiente de produção para autenticar-se no ambiente de homologação.