ndice Índice
Objetivo
O objetivo deste documento é trazer uma visão de como configurar o Totvs Update para acesso local e remoto. o Smart Client RM utilizando o configurador global de forma com o que a configuração esteja praticamente toda no servidor.
Isso facilita muita a gestão de configuração de ambiente, alem de tornar mais transparente as configurações de servidor.
Introdução
Para utilizar o TOTVS Update para acesso local e remotoSmart Client com o Configurador Global, é necessário informar somente o endereço HTTP do servidor de aplicação ou o caminho do arquivo de configuração global no arquivo .config dos aplicativos,conforme exemplos abaixo.
Será alterar o arquivo RM.EXE.Config e informar os IPS que devem responder, de acordo com o domínio da máquina. Para isso, será necessário criar um arquivo de configuração unificada. Veja detalhes desse arquivo neste link.
A seguir, será apresentado um modelo de como o arquivo RM.EXE.Config deve ser.
Mais detalhes ao longo desta documentação.
Arquivo [Aplicação].config
Informações |
---|
[Aplicação] é o nome do EXE que está sendo configurado, seja ele RM.exe, RM.Host.Service.exe, RM.AliasManager.exe, etc. |
Arquivo RM.EXE.Config Seu arquivo RM.EXE.Configconfig deverá conter apenas a chave do local do somente o caminho do arquivo de configuração global. Essa informação estará na tag configpath. Onde, IPEXTERNO ENDEREÇOEXTERNO será substituído pelo endereço ou IP do servidor de aplicação onde o arquivo de configuração global está hospedado.
O Caminho do arquivo global configuracaorm.config deve estar definido na tag CONFIGPATH, no arquivo de configuração do seu aplicativo.
Bloco de código |
---|
|
<add key="configpath" value="http://IPEXTERNO/ConfiguracaoRM.config.xmlENDEREÇOEXTERNO:8051/" /> |
O caminho pode ser definido de forma absoluta ou relativa.
O Como exemplo, adicionamos o arquivo configuracaorm.config no caminho c:/RM/Atual/Release/bin/arquivo/configuracaorm.config
A forma absoluta é quando o caminho do arquivo é adicionado por completoarquivo RM.EXE.Config terá o seguinte layout:
Bloco de código |
---|
|
<?xml version="1.0"?>
<configuration>
<appSettings>
<add key="configpath" value="httpc:/RM/IPEXTERNO/ConfiguracaoRM.config.xml" />
</appSettings>
<runtime>
<NetFx40_LegacySecurityPolicy enabled="true" />
<generatePublisherEvidence enabled="false" />
<loadFromRemoteSources enabled="false" />
</runtime>
<startup useLegacyV2RuntimeActivationPolicy="true">
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" />
</startup>
</configuration> |
Aviso |
---|
|
O arquivo de configuração deverá ser hospedado dentro de qualquer servidor WEB público. |
Arquivo de Configuração Unificada
O arquivo de Configuração deve conter dados de conexão do host que será utilizado quando a conexão for feita de uma máquina em um domínio interno específico:
Bloco de código |
---|
|
<RM.EXE_BH01.LOCAL_DEFAULT>
<appSettings>
<add key="JobServer3Camadas" value="true" />
<add key="Port" value="3443" />
<add key="Host" value="localhost" />
<add key="ActionsPath" value="C:\TOTVS\RM.NET" />
<add key="LibPath" value="C:\TOTVS\RM.NET" />
<add key="EnableDynamicLocalization" value="false" />
<add key="EnableCompression" value="true" />
<add key="LocalizationLanguage" value="pt-BR" />
</appSettings>
</RM.EXE_BH01.LOCAL_DEFAULT> Atual/Release/bin/arquivo" /> |
Na forma relativa, o caminho do arquivo é adicionado a partir do local de instalação do aplicativo:
Bloco de código |
---|
|
<add key="configpath" value="./arquivo" /> |
O arquivo RM.EXE.Config terá o seguinte layout:
Bloco de código |
---|
|
<?xml version="1.0"?>
<configuration>
<appSettings>
<add key="configpath" value="c:/RM/Atual/Release/bin" />
</appSettings>
</configuration> |
Arquivo de Configuração Global ou Unificada
Aviso |
---|
|
Veja detalhes do arquivo de configuração unificada neste link. |
O configurador global tem capacidade de receber diferentes grupos de configuração, podendo ser divididos em aplicação, domínio e nome da máquina. O _ é utilizado para separa cada identificador desses grupos.
Por exemplo:
<RM.EXE_BH01.LOCAL_NOTEBOOK1> - Neste caso a configuração será aplicada para a aplicação RM.exe, domínio BH01.LOCAL e o computador NOTEBOOK1.
<RM.EXE_BH01.LOCAL_DEFAULT> - Neste caso a configuração será aplicada para a aplicação RM.exe, domínio BH01.LOCAL e qualquer máquina.
<RM.HOST.EXE_TODOS_DEFAULT> - Neste caso a configuração será aplicada para a aplicação RM.exe, qualquer domínio e qualquer computador.
<RM_TODOS_DEFAULT> - Neste caso a configuração será aplicada a qualquer aplicativo, domínio e máquina.
Informações |
---|
A configuração mais especifica sempre sobrepõe a configuração mais genérica, caso haja este cenário no arquivo de configuração global. |
Image Added
No exemplo acima, na tag <RM.EXE_BH01.LOCAL_DEFAULT>, foi definido que máquinas que estiverem no domínio BH01.LOCAL, acessarão o host localmente. A tag A tag Host deve identificar o endereço da rede interna, onde o host responderá.
O arquivo deve conter também, os dados de conexão do host que será utilizado quando a conexão for feita por uma máquina fora do domínio especificado anteriormente:
Bloco de código |
---|
|
<RM.EXE_TODOS_DEFAULT>
<appSettings>
<add key="JobServer3Camadas" value="true" />
<add key="Port" value="3443" />
<add key="Host" value="BHN000000984" />
<add key="ActionsPath" value="C:\TOTVS\RM.NET" />
<add key="LibPath" value="C:\TOTVS\RM.NET" />
<add key="EnableDynamicLocalization" value="false" />
<add key="EnableCompression" value="true" />
<add key="LocalizationLanguage" value="pt-BR" />
</appSettings>
</RM.EXE_TODOS_DEFAULT> |
Image Added
No exemplo acima, na tag <RM.EXE_BH01.LOCALTODOS_DEFAULT>, foi definido que todas as máquinas que não estiverem no domínio BH01, acessarão o host de forma pública. A tag A tag Host deve identificar o endereço IP onde o host responderá.
Lembre-se de alterar o nome do domínio no cabeçalho do arquivo de configuração unificada:
Image Added
Aviso |
---|
| Veja detalhes do arquivo neste link. |
O usuário do IIS e do Host precisa ter acesso ao arquivo de configuração global. |
Acesse nos links abaixo os arquivos de configuração com configurações padrão que podem ser utilizado em qualquer instalação.
Configuracaorm.config
RM.exe.config
RM.Host.exe.config