Configurando o HOST como Multi Tenancy

1. Fazer a instalação do Server do RM no servidor e configurá-lo como servidor de atualização conforme documentação disponível neste link.
2. Criar um alias de banco para cada Tenant e dar um nome que possa ser inserido em um domínio, subdomínio ou nome de recurso de rede.
3. Criar o arquivo de configuração global contendo a tag SubDomainMask respeitando os seguintes critérios:
   Vamos supor que você possui dois Tenants onde seus respectivos Alias são: cliente1 e cliente2.
   - Se o seus subdomínios forem: cliente1.empresa.com e cliente2.empresa.com então a tag SubDomainMask deve ser [ALIAS].empresa.com
   - Se o seus domínios forem: www.cliente1.com e www.cliente2.com então a tag SubDomainMask deve ser www.[ALIAS].com
   - Se o seus nomes de rede forem: cliente1 e cliente2 então a tag SubDomainMask deve ser somente [ALIAS]
4. Os arquivos de .config de cada aplicação devem conter apenas a tag configpath, conforme documentação acima relacionada.
5. Seguem exemplos de como devem ficar os arquivos de configuração: RM.AliasManager.exe.config, RM.exe.config , RM.Host.exe.config, ConfiguracaoRM.config

6. As tags UpdateServer e ServicesHostName devem direcionar para um endereço padrão

   ou para qualquer um Tenant

   válido, pois não faz nenhuma diferença, por ser uma tag relacionada à ambiente e infraestrutura.

   Aviso
   title Atenção
   Especificamente para a tag ServicesHostName recomendamos utilizar um endereço válido que exponha os serviços, mas sem um tenant específico. Exemplo: tenant.dominio.com Ao utilizar o WSDL é importante que o cliente de consumo, SOAP UI por exemplo, consiga obter uma resposta deste endereço, mas o cliente deverá obrigatoriamente trocar o tenant pelo nome correto do seu Alias para consumir o serviço. Image Added Ao adicionar o WSDL no SOAP UI, por exemplo teremos o seguinte nas requisições: Image Added O trecho tenant deve ser trocado pelo nome do Alias que representa o tenant do cliente.   Não é possível expor WSDLs específicos por tenant.

7. Os arquivos acima devem ficar no diretório de instalação do RM (RM.Net) no servidor.
8. Feito isso os domínios, subdomínios ou nomes de rede devem ser criados de forma compatível com a configuração acima.
9. Feito isso basta acessar normalmente as URLs de serviço, como por exemplo:
   1. http://empresa1.totvs.com.br:8051/wsUpdate  - Este para baixar o SmartClient e utilizar já com o alias correto de forma transparente.
   2. http://empresa1.totvs.com.br:8051/wsReport  - Este para gerar relatórios via web service.
   3. Após baixar o Smart Client, basta executá-lo que ele já estará configurado corretamente para o Tenant correto.
      
      

Como funciona?

Com o ambiente configurado, o Portal Corpore.NET, FrameHTML, Web Services (somente expostos pelo HOST, conforme recomendado) e RM.exe farão a escolha do Tenant de forma transparente. Exemplo:

• Criamos apenas UMA instalação do RM e configuramos a tag SubDomainMask com a informação [ALIAS].totvs.com.br nos arquivos de confguração, confirme orientação acima.
• Neste exemplo considero que temos os portais e o servidor de aplicação (HOST) instalado no ambiente.
• O primeiro cliente vai utilizar o ambiente, então chamaremos ele de cliente1.
• Criamos um alias de nome cliente1 no ambiente.
• Criamos um subdomínio público, direcionado para o ambiente de instalação, chamado cliente1.totvs.com.br.
• O cliente agora pode acessar o endereço http://cliente1.totvs.com.br:8051/wsUpdate para baixar o SmartClient.
• O SmartClient não dará opção para selecionar alias, pois será resolvido de forma transparente.
• Os WebServices podem ser listados através do endereço http://cliente1.totvs.com.br:8051/wsPageIndex.
• Não será necessário configurar nenhum alias Default.
• O portal pode ser acessado pelo endereço http://cliente1.totvs.com.br/Corpore.Net e também não terá opção para selecionar alias.
• O segundo cliente vai utilizar o ambiente, então chamaremos ele de cliente2.
• Criamos um alias de nome cliente2 no ambiente.
• Criamos um subdomínio público, direcionado para o ambiente de instalação, chamado cliente2.totvs.com.br.
• Basta isso e o cliente2 pode acessar da mesma forma que o cliente1, porem com o endereço cliente2.totvs.com.br.
• Em resumo, os dois clientes estão utilizando o mesmo ambiente de forma tranparente e sem a necessidade de se preocupar em selecionar o alias.