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.
   A partir da versão 12.1.28, o Multi Tenancy pode ser configurado com o novo formato de configuração global, em JSON: Leia mais. 
   Exemplo dos arquivos de configuração em formato JSON:  RM.AliasManager.exe.config, RM.exe.config, RM.Host.exe.config, Global.config.json. 

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.

   Aviso
   icon false
   Atualmente para o consumo do WebServices via Host através do software SoapUI, foi criada uma tag opcional que pode ser acrescentado no host (com a porta de escuta do WebApi no TGM): <add key="SERVICESPORT" value="9001" />

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.
      Obs.: Ao baixar o Smart Client de ambiente Multi Tenancy, as telas de gerenciamento de Alias se comportam da seguinte forma:
         - Se baixado na mesma máquina onde está o ambiente server: É possível visualizar e editar apenas o cadastro do Alias do Tenant.
         - Se baixado em máquina diferente de onde está o ambiente server: É possível apenas visualizar o cadastro do Alias do Tenant.
         Em ambos os casos, na tela de login não é possível alterar o Alias, pois ele carrega apenas o Tenant correto.