Produto:Framework                         Versão: 11.52                                                                        
Processo:Parâmetros para Config
Subprocesso:Configuração arquivos *.Config
Data da publicação:21/02/2014
      Os arquivos config do Host e executáveis contém uma série de configurações extremamente importantes para o funcionamento do sistema. Assim sendo, segue abaixo uma lista das principais opções, seus valores default e descrições, de forma a facilitar o entendimento das configurações.

ActionsPath

Descrição: String - Caminho onde estão as actions utilizadas no sistema. Pode conter mais de um caminho, separado por ponto e vírgula.

Exemplo: <add key="ActionsPath" value="c:\rm.net\bin;c:\corpore.net\bin"/>

BadSyntaxLogEnabled

Descrição: Booleano - Habilita o salvamento dos logs de operações ilegais no banco de dados, como select * e expressões sem nolock.

Exemplo: <add key="BADSYNTAXLOGENABLED" value="true" />

Default: false

CertificateStoreLocation

Descrição: String - Nome do Lugar onde a Store do certificado de segurança do WCF está localizada. Habilitado somente no host.

Possíveis Valores:  CurrentUser  e  LocalMachine

Default: CurrentUser

CertificateStoreName

Descrição: String - Nome do Store onde o certificado de segurança do WCF está armazenado. Habilitada somente no host.

Possíveis valores:

 

        - AddressBook

        - AuthRoot

        - CertificateAuthority

        - Disallowed

        - My

        - Root

        - TrustedPeople

        - TrustedPublisher

 

        Default: My

 

CertificateFindType

 

    Descrição: String - Campo pelo qual o certificado de segurança será procurado no Certificate Store. Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegida. Habilitada somente no host.

    Possíveis valores:

 

        - FindByThumbprint

        - FindBySubjectName

        - FindBySubjectDistinguishedName

        - FindByIssuerName

        - FindByIssuerDistinguishedName

        - FindBySerialNumber

        - FindByTimeValid

        - FindByTimeNotYetValid

        - FindByTimeExpired

        - FindByTemplateName

        - FindByApplicationPolicy

        - FindByCertificatePolicy

        - FindByExtension

        - FindByKeyUsage

        - FindBySubjectKeyIdentifier

 

            Default: FindByThumbprint

 

CertificateFindValue

 

    Descrição: String - Valor pelo qual o certificado de segurança será procurado no Certificate Store. Habilitada no host e deve conter o nome do certificado no client.

    Este valor ajuda a encontrar o certificado correto com que a comunicação do sistema será protegida. Trabalha em conjunto com a chave CertificateFindType.

    Para que seja levada em conta, a comunicação deve estar ocorrendo em WCF e a chave SecurityEnabled habilitada.

    Default: vazio

 

 

CommunicationStyle

 

    Descrição: String - Plataforma de comunicação a ser utilizada entre host e client. Os valores possíveis são WCF, Remoting e Todos. Caso selecionado o valor "Todos", a comunicação utilizará preferencialmente WCF e, se o serviço não estiver migrado, Remoting.

    Exemplo: <add key="CommunicationStyle" value="Remoting" />

    Default: WCF

 

DbSchemaCacheMaxSize

 

    Descrição: Define a quantidade de schemas que serão guardados em cache.

     Exemplo: <add key="DBSchemaCacheMaxSize" value="123" />

     Default: 100

 

DBSCommandTimeout

 

    Descrição: Define o tempo máximo que uma Consulta SQL pode levar antes de retornar erro de timeout, em segundos.

    Exemplo: <add key="DBSCommandTimeout" value="600" />

    Default: 120

 

DefaultDB

 

    Descrição: String - Banco de dados default para qualquer operação que possa vir a ser realizada antes do momento do login, quando o banco de dados definitivo é definido

    Exemplo: <add key="DefaultDB" value="CorporeRM1120" />

    Default: CorporeRM

 

EnableSecurity

 

    Descrição: Determina se a comunicação WCF utilizará a segurança da camada de transporte garantida por certificados e se permitirá que credenciais sejam enviadas aos serviços.

    Ao setar esta tag como true, suas respectivas tags de parametrização também precisam ser configuradas, são elas: CertificateFindValue, CertificateFindType, CertificateStoreName, CertificateStoreLocation, que basicamente definem onde e como encontrar o certificado adequado.

    Default: false

 

Host

 

    Descrição: Nome da máquina em que o host está sendo executado (não recomendável pois acrescenta o overhead de ir ao DNS). O ideal é informar o IP diretamente. Aplicável somente em configs de clientes.

     Exemplos: <add key="Host" value="localhost" />  e  <add key="Host" value="10.31.8.91" />

 

HostClientPort

 

    Descrição: Descontinuado

 

HttpPort

 

    Descrição: Inteiro - Porta utilizada pela comunicação WCF (CommunicationStyle=WCF) quando o protocolo de comunicação for HTTP (WcfProtocol=HTTP). Caso a comunicação esteja sendo feita em Remoting, desconsidera este parâmetro. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente.

    Exemplo: <add key="HttpPort" value="1234" />

    Default: 8061

 

JobServer3Camadas

 

    Descrição: Booleano - Informa se a aplicação está trabalhando em 3 camadas. Deve ter o mesmo valor tanto nos configs dos Clients quanto do Host.

    Exemplo: <add key="JobServer3Camadas" value="true" />

        Default: false

 

LdapProvider

 

    Descrição: Possível provider que irá responder por operações relacionadas a autenticação caso exista a integração LDAP.

 

LibPath

 

    Descrição: String - Diretório onde estão as dlls da lib.

 

LogPath

 

    Descrição: String - Caminho do diretório de log .

 

LSFOV

 

    Descrição: Indica se há necessidade de alterar o padrão de licenciamento.

 

MaxRecords

 

    Descrição: Define a quantidade máxima de registros que um select pode retornar. Descontinuado a partir da versão 10.80.

 

NotificationsPerLicenceServerCicle

 

    Descrição: Inteiro maior que 0 - Número de notificações que o ERP fará no Licence Server a cada ciclo do mesmo. O Licence Server exige que a cada intervalo de 3 minutos, pelo menos uma notificação seja feita pelo cliente. Contudo, por problemas de rede, algumas notificações podem se perder ou atrasar. Devido a isto mais notificações podem ser configuradas. Quanto pior a rede, maior deve ser o número de notificações. Se algum valor inválido for informado, o default 3 é utilizado. Definido nos configs dos clientes.

    Exemplo: <add key="NotificationsPerLicenceServerCicle" value="10" />

    Default: 3

 

PerformanceLogEnabled

 

    Descrição: Tag utilizada para mostrar o tempo gasto para abrir/editar/gravar dados.

    Indicado ser utilizada quando o cliente reclamar de performance, coletando os dados para análise.

    Ex: Com a TAG ativada nos arquivos configs (rm.exe.config, rmlabore.exe.config e etc) o sistema exibirá uma tela mostrando o tempo gasto em operações gerais como abertura de uma tela de visão

    Exemplo: <add Key = “PERFORMANCELOGENABLED” value = “True”>

    Default: false

 

Port

 

    Descrição: Informa em que porta Host e Client se comunicarão quando a plataforma de comunicação for Remoting. Ao utilizar WCF (Parâmetro CommunicationStyle), esta configuração é desconsiderada. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente.

     Exemplo: <add key="Port" value="1234" />

    Default: 8050

 

QueryWaitTimeToLog

 

    Descrição: QueryWaitTimeLog trabalha em conjunto com BadSyntaxLogEnabled. Ao incluir BadSyntaxLogEnabled nos arquivos CONFIG, o sistema passa a gravar operações ilegais (select * from XXX) no banco de dados. Ao incluir nos configs a tag <add key "QUERYWAITTIMETOLOG"value = "120"/>, o sistema passará a gravar operações que superem um determinado tempo.

     Default: 120 segundos

 

SecurityExtCacheMaxSize

 

    Descrição: Define a quantidade máxima de tabelas relacionadas às configurações de segurança estendida que podem estar em cache.

 

SelfHosted

 

    Descrição: Booleano - Informa se a aplicação starta o Host automaticamente caso ele não esteja iniciado. Se o serviço RM.Host.Service.exe estiver habilitado, inicia-o. Caso o serviço não esteja ou não exista, inicia o Host desktop. Este parâmetro é configurado nos clientes, não sendo levado em consideração quando configurado no server.

    Exemplo: <add key="SelfHosted" value="true" />

    Default: false

 

ServerUrl

 

    Descrição: Descontinuado

 

ServiceAlias

 

    Descrição: Define o alias que responderá pelos serviços executados sem autenticação

 

 

 

ServicePassword

 

    Descrição: Descontinuado, passou a utilizar a tabela GSERVICO.

 

ServiceUser

 

    Descrição: Descontinuado, passou a utilizar a tabela GSERVICO.

 

TcpPort

 

    Descrição: Inteiro - Porta utilizada pela comunicação WCF (CommunicationStyle=WCF) quando o protocolo de comunicação for TCP (WcfProtocol=TCP). Caso a comunicação esteja sendo feita em Remoting, desconsidera este parâmetro. Tanto o Server quanto o Client devem estar configurados sempre na mesma porta, para que possam se comunicar corretamente.

    Exemplo: <add key="TcpPort" value="4321" />

    Default: 8060

 

TraceConsole

 

    Descrição: Booleano – Loga em arquivo as informações que forem inseridas pela aplicação no console.

    Exemplo: <add key="TraceConsole" value="True" />

    Default: False

 

TraceEventViewer

 

    Descrição: Booleano – Loga em arquivo as informações que forem inseridas pela aplicação no Event Viewer

    Exemplo: <add key="TraceEventViewer" value="True" />

    Default: False

 

TraceFile

 

    Descrição: Indica se irá salvar algum log de execução do host dentro pasta \Processos\Logs\Broker\.

    Exemplo: <add key="TraceFile" value="True" />

 

UseDbSchemaCache

 

    Descrição: Indica se o sistema guardará em cache os esquemas obtidos pelas consultas.

 

UseExternalHost

 

    Descrição: Booleano - Informa se o Host da aplicação trabalhará internamente ou como um executável separado. A partir da versão 11.20 não é mais utilizado, pois o Host será sempre externo. Este parâmetro é configurado no cliente, não sendo considerado quando inserido no Host.

    Exemplo: <add key="UseExternalHost" value="true" />

     Default: False (True a partir da versão 11.20)

 

UseHostClient

 

    Descrição: Descontinuado

 

UseSecurityExtCache

 

      Descrição: Indica se o sistema guardará em cache as informações de segurança estendida obtidas a cada verificação.

 

WcfProtocol

 

    Descrição: String - Protocolo utilizado pela comunicação entre Host e Client quando a plataforma utilizada for WCF (CommunicationStyle=WCF) .

    Caso a comunicação esteja sendo feita em Remoting, desconsidera este parâmetro. Os valores aceitos são HTTP, TCP, NamedPipe e All. Este parâmetro deve ter o mesmo valor tanto no Server quanto no Client. Somente o host pode ser configurado para "All". Neste caso, ele publicará os Servers tanto em HTTP quanto em TCP, e os clientes poderão se comunicar com ele em qualquer dos protocolos.

    A opção NamedPipe é a mais rápida das três. Contudo, esta comunicação só pode ser configurada quando host e client estiverem na mesma máquina. Para fazer esta verificação, a chave JobServer3Camadas é conferida. Caso esteja setada para true, utiliza o padrão TCP mesmo que esteja configurado para NamedPipes.

    Exemplo: <add key="WcfProtocol" value="http" />

     Default: TCP em 3 camadas, NamedPipes em 1 camada.

 

Consulte o WikiHelp TOTVS


COMUNIDADE  @FRAMEWORK


Canais de Atendimento:

Chamado: Através do Portal Totvs www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 –  (Gerador de Relatórios e Planilha).