Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

ÍNDICE

  1. Visão Geral
  2. Exemplo de utilização
    1. Configurando HttpPort e ApiPort via RM.Host.ServiceManager.exe
    2. Alterando HttpPort e ApiPort via arquivos de configuração


01. VISÃO GERAL

Para utilizar o RM é possível configurar portas de comunicação com serviços WebServices (HttpPort) e serviços de WebAPI (ApiPort).

Até a versão 12.1.24, WebServices e APIs respondem pela mesma porta. É utilizado o valor configurado na tag 'HTTPPort' no arquivo de configuração do host.

A partir da versão 12.1.25, é possível utilizar portas diferentes para requisições WebService e de WebAPI.
Basta configurar as tags 'HttpPort' e 'ApiPort' no arquivo de configuração do Host.
As portas também podem ser configuradas pelo RM.Host.ServiceManager.exe.

Informações
titleLembrete:

Não é obrigatório que as portas sejam diferentes. Por default, ambas responderão na porta 8051.

Aviso
titleAtenção

As portas devem estar devidamente reservadas na rede. Mais informações sobre essa configuração, acesse o link.

02. EXEMPLO DE UTILIZAÇÃO

Configurando HttpPort e ApiPort via RM.Host.ServiceManager.exe:

Para configurar as portas pelo RM.Host.ServiceManager.exe (C:\totvs\CorporeRM\RM.Net), basta abrir o aplicativo e com um duplo clique na porta desejada, altere o valor. 

Por default os valores das portas do primeiro host são:

  • Porta WCF: 8050 
  • Porta WebService: 8051
  • Porta WebApi: 8051

Image Added

Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do Host.


Alterando HttpPort e ApiPort via arquivos de configuração:

Para incluir/editar as portas pelo arquivo de configuração, acesse o diretório 

Configurando HTTPPort

 
Para inclusão da tag HTTPPort acesse a máquina ou servidor que está executando o seu RM Host. Vá ao diretório C:\totvs\CorporeRM\RM.Net, e edite os arquivos RM.Host.exe.config e RM.Host.Service.exe.config. Inclua a tag

Image Added
Inclua/edite as tags abaixo, em ambos os arquivos, dentro do escopo das tags appSettings:

<add key="ApiPort" value="8051" />
<add key="

...

HttpPort" value="8051" />


Obs.: Neste exemplo utilizamos a porta 8051, caso esta seja utilizada para outra finalidade o departamento de TI deverá informar outra porta para uso.


Exemplo: em ambos os arquivos dentro da limitação appSettings. O valor a ser atribuído a tag HTTPPort deve ser idêntica ao nome do alias que aponta para a base de dados utilizada. No nosso exemplo que citamos atribuímos o valor "CorporeRM" ao alias e respectivamente ao DefaultDB. Exemplo;

RM.Host.exe.config

RM.Host.Service.exe.config

<?xml version="1.0"?

> <configuration>


<configuration> 
  <appSettings

>


       <add key="JobServer3Camadas" value="false" /

>


       <add key="Port" value="8050" /

>


       <add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" /

>


       <add key="EnableCompression" value="true" /

>       


       <add key="

DefaultDB

ApiPort" value="

CorporeRM

8051" />

  </appSettings> <runtime>        <NetFx40_LegacySecurityPolicy enabled="true" /> </runtime>        <system.runtime.remoting>        <customErrors mode="Off" />        </system.runtime.remoting> <startup>        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" /> </startup> </configuration>

      <add key="HttpPort" value="8051" />
  </appSettings
<runtime> 
...

<?xml version="1.0"?

> <configuration>


<configuration> 
  <appSettings

>


       <add key="JobServer3Camadas" value="false" /

>


       <add key="Port" value="8050" /

>


       <add key="ActionsPath" value="C:\totvs\CorporeRM\RM.Net;C:\totvs\CorporeRM\Corpore.Net\Bin" /

>


       <add key="EnableCompression" value="true" /

>       


       <add key="

DefaultDB

ApiPort" value="

CorporeRM

8051" />

  </appSettings> <runtime> <NetFx40_LegacySecurityPolicy enabled="true" /> </runtime> <system.runtime.remoting> <customErrors mode="Off" /> </system.runtime.remoting> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0" /> </startup> </configuration>

...

      <add key="HttpPort" value="8051" />

  </appSettings
<runtime> 
...



Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do

...

Host.

...


...