Este manual tem como objetivo de apresentar a como configurar e instalar os componentes utilizado pelo TMS . assim mostrando a como configurar os arquivos e serviços necessários.
Configurações de arquivos de conexão
1 - Viasoft.AgroServer
Abrir o arquivo Viasoft.Agro.Server, disponível na pasta raiz de instalação do sistema. Neste arquivo, deverá ser adicionada a estrutura abaixo:
[XDATA]
Protocolo=1
ServerIP=127.0.0.1
ServerPort=2001
Timeout=30
JobServerIP=127.0.0.1
JobServerPort=2003
JobUrlBase=viasoftjob
2 - Principal.conexoes
Criar o arquivo Principal.conexoes, dentro da pasta Viasoft/Server/Agro. Neste arquivo será definida as conexões de banco de dados, conforme estrutura abaixo:
[FIREBIRD]
Server=localhost
Database=D:\Viasoft\Dados\AGRO.FDB
Username=VIASOFT
Password=153
ProviderName=Interbase
Protocol=TCPIP
[ORACLE]
Server=localhost:1521:ORCL
Username=VIASOFT
Password=VIASOFT
ProviderName=Oracle
CharLength=0
Charset=
ClientIdentifier=
ConnectionTimeout=0
ConnectMode=cmNormal
DateFormat=
DateLanguage=
Direct=true
EnableIntegers=True
EnableLargeInt=false
PrecisionInteger=9
PrecisionLargeint=19
PrecisionSmallint=0
Execute01=ALTER SESSION SET NLS_LANGUAGE = "BRAZILIAN PORTUGUESE"
Execute02=ALTER SESSION SET NLS_TERRITORY = BRAZIL
Execute03=ALTER SESSION SET NLS_DATE_FORMAT = 'MM/DD/YYYY'
Execute04=ALTER SESSION SET NLS_NUMERIC_CHARACTERS = '.,'
3 - viasoft.Agro.conexoes
Criar o arquivo viasoft.Agro.conexoes, dentro da pasta Viasoft/Client. Neste arquivo, deverá ser adicionada a estrutura abaixo:
[XDATA]
Count=2
Item0=FIREBIRD
Item1=ORACLE
Definições:
Parâmetro | Significado |
---|
Count | Quantidade de conexões |
Item | Nome de cada conexão do banco de dados conforme definido nome da conexão definido no arquivo Principal.conexoes. |
4 - ViasoftServerAgroX.conf
Caso não exista, esse arquivo deve ser criado na pasta Viasoft/Server/Agro. Onde deve conter a estrutura abaixo:
Arquivo de configuração do ViasoftServerAgroX.conf
#{*******************************************************}
#{ }
#{ Arquivo de Configuração do Serviço de Agro Api }
#{ }
#{ Copyright(c) 1995-2022 Viasoft Tecnologia }
#{ }
#{*******************************************************}
[Conexoes]
ArquivoConexoes={AppPath}\Principal.conexoes
[Portas]
UrlBase=http://+:2001/viasoft
#UrlBase=http://+:2001/viasoft
[Pool_Config]
MaxConnections=500
[Debug]
DebugFileLevel=1
DebugFile={AppPath}\server.log
DebugFileDiario=1
DebugClear=1
DebugFileRequests={AppPath}\requests.log
[Auditoria]
Capacidade=0
BatchCriar=
AuditElasticSearch=N
AuditElasticSearchIp=127.0.0.1
AuditElasticSearchPorta=8585
AuditElasticSearchFilaPorta=8161
AuditElasticSearchNotificaoFalhaPermiteLogin=0
AuditElasticSearchNotificaoFalhaNotificar=0
AuditElasticSearchNotificaoFalhaNotificarLog=0
AuditElasticSearchNotificaoFalhaNotificarEMail=0icarLog=1
AuditElasticSearchNotificaoFalhaNotificarEMail=0
4.1 - Definições
Parâmetro | Significado |
---|
ArquivoConexoes | Refere-se ao caminho do arquivo de conexões do banco de dados, neste caso, o Principal.conexoes. |
UrlBase | Define a porta do servidor do ViasoftServerAgroX. |
5 - ViasoftServerAgroApi.conf
Caso não exista, esse arquivo deve ser criado na pasta Viasoft/Server/Agro. Onde deve conter a estrutura abaixo:
Arquivo de configuração do ViasoftServerAgroApi.conf
#{*******************************************************}
#{ }
#{ Arquivo de Configuração do Serviço de Agro Api }
#{ }
#{ Copyright(c) 1995-2022 Viasoft Tecnologia }
#{ }
#{*******************************************************}
[Conexoes]
# Configura o nome de arquivo de conexões a ser usado pelo serviço.
# Deixe comentado para usar o padrão ViasoftServerAgroApi.conexoes
# Exemplos:
ArquivoConexoes={AppPath}\Principal.conexoes
;ArquivoConexoes=.\Principal.conexoes
[Portas]
# Configura a url base a ser usada para acessar e consumir os serviços e endpoints.
# O padrão é http://+:2001/viasoftserver que representa o acesso ao computador localhost e porta 2001.
UrlBase=http://+:2002/viasoftserver
[Pool_Config]
# Número de conexões com o banco de dados que serão criadas quando o primeiro cliente se conectar.
# O padrão é 1 conexão
MinConnections=1
# Número máximo de conexões que serão criadas no pool.
# Se este limite for atingido, a tentativa de obter uma nova conexão irá gerar um log de erro no serviço.
# O padrão é 10 conexões
MaxConnections=100
# Número de conexões que serão criadas a cada vez que for necessário expandir o pool.
# O padrão é 1 conexão
Incremento=1
# Tempo máximo que uma conexão pode ficar aberta sem uso. Evita o acumulo de conexões ativas em desuso
# que acabam consumindo recursos do servidor.
# O padrão é 1 minuto. Deixe 0 para desativar.
ConnectionTimeoutDB=1
ConnectionTimeout=30
# Tempo máximo (em minutos) que uma conexão pode ficar livre sem uso no Pool. Evita o acumulo de conexões ativas.
# 0=desativado
# Padrão é 0.
TimeoutConexaoLivre=0
# Grava no banco de dados (nas variáveis de sessão) o código do usuário logado para cada conexão criada no pool.
# 0-Não;1-Sim
# Padrão é 0.
UserIdSession=0
[Debug]
# Nível de detalhe das mensagens a ser geradas no log em arquivo. Podem ser configurados valores de 0 a 9.
# 0-Nenhuma; 1-Apenas erros; 9-Mais detalhado
# O padrão é 1.
DebugFileLevel=1
# Nome e caminho do arquivo onde devem ser os logs.
# Exemplo: Z:\Viasoft\App\xdata\server_DATA.log
DebugFile=C:\D\ZREDE\Z\Viasoft\App\LOG\server_DATA.log
# Informa se deve ser mantido um arquivo de log separado para cada dia.
# Esta opção substitui a palavra DATA no nome do arquivo pela data.
# Exemplo: server_DATA.log > server_2022-01-01.log
# 0-Desativado; 1-Ativado
DebugFileDiario=1
# Limpar o arquivo de log a cada execução. Se desativado o arquivo de log pode ficar muito grande.
# 0-Desativado; 1-Ativado
DebugClear=0
# Informa quando tempo o Nível de detalhes deve ficar habilitado. Possíveis configurações:
# 0 - Até reiniciar o servidor;
# 1 - 10 minutos
# 2 - 30 minutos
# 3 - 2 horas
# 4 - 4 horas
# 5 - 12 horas
# 6 - 24 horas
# O padrão é -1 (Desabilitado).
DebugTimer=-1
# Nome e caminho do arquivo onde devem ser salvas as requisições que forem feitas. Deve ser usada apenas para debug.
DebugFileRequests=C:\D\ZREDE\Z\Viasoft\App\LOG\requests.log
[DebugSQL]
# Informa se deve ser gerado log das SQLs.
# 0-Desativado; 1-Ativado
DebugSQLmonitorar=0
# Nome e caminho do arquivo onde devem ser os logs de SQL.
# Exemplo: D:\Viasoft 729\Server\AgroXE\Log\
DebugSQLFile=C:\D\ZREDE\Z\Viasoft\App\LOG\SQL_DATA.log
# Limpar o arquivo de log a cada execução. Se desativado o arquivo de log pode ficar muito grande.
# 0-Desativado; 1-Ativado
DebugSQLclear=0
[Auditoria]
Capacidade=0
BatchCriar=
AuditElasticSearch=N
AuditElasticSearchIp=127.0.0.1
AuditElasticSearchPorta=8585
AuditElasticSearchFilaPorta=61613
AuditElasticSearchNotificaoFalhaPermiteLogin=0
AuditElasticSearchNotificaoFalhaNotificar=1
AuditElasticSearchNotificaoFalhaNotificarLog=1
AuditElasticSearchNotificaoFalhaNotificarEMail=0
[Notificacoes]
NotificacaoAtiva=0
SMTPHost=204255255253254055002
SMTPPorta=587
SMTPUsuario=204255255253254055002
SMTPSenha=204255255253254055002
SMTPUsaAutenticacao=1
SMTPAutenticacao=-1
SMTPAutVerSSL=-1
SMTPAutTSLTP=-1
RemetenteNome=204255255253254055002
Remetente=204255255253254055002
SMTPPrefixoAssunto=840671211900192131310481511101210231511700790390190191511501700792220131801011401510861900990191410860
NotificacaoIntervalo=5
[Avancado]
# Exporta a lista de bancos de dados para o cliente.
# Se estiver marcado o cliente recebe uma lista com o nome das conexões disponíveis. Caso contrário ele deve informar o nome da conexão que deseja usar.
# Ideal em Data Centers compartilhados
# 0-Não;1-Sim
# Padrão é 0.
ExportarListaBD=1
[NFe]
URL=
TIMEOUT=600
# Salva os xmls das NFes na pasta/caminho indicado
PathXML=
# Salvar os xmls das NFe.
# 0-Não;1-Sim
# Padrão é 0.
SalvarXML=0
# Nome da conexão MD-e automático
CONEXAOMDE=
[CTe]
# Salva os xmls dos CTes na pasta/caminho indicado
PathXMLCTE=
# Salvar os xmls dos CTes.
# 0-Não;1-Sim
# Padrão é 0.
SalvarXMLCTE=0
[NFSe]
DIRETTRANSMITIR=
DIRETAUTORIZADOS=
DIRETERROS=
TIMEOUT=20
[DFe]
# Deve-se ligar o nome da conexao com o o banco de dados com o sistema para que o servidor DF-e funcione corretamente
# Os sistemas disponíveis são: AGRO, AUTOCML, CONSTRUSHOW, MERCADO, PETROSHOW
# Exemplo abaixo
# CONEXAO_ORACLE=AGRO
[Console_Abast]
# Nome da conexão do abastecimento
# Padrão em branco
Conexao=
# Timer de abastecimentos (em segundos)
Timer=0
# Timer de statuso de bombas e bicos (em segundos)
TimerStatusBombaBico=0
[Portas]
PortServer=300
PortServerRest=301
PortMsgUser=311
KeepAliveEnabled=1
KeepAliveTime=1
PortComAgente=9099
[Agendador_Tarefas]
# Indica se o agendador de tarefas está ativo ou não: 0-Não; 1-Sim
AgendadorTarefasAtivo=1
# Define o intervalo (em minutos) da execução do Job que efetiva os procedimentos genericos do servidor.
TempoJobGeral=5
# Ativa a limpeza de memória residual: 0-Não;1-Sim
LimparMemoriaResidual=0
# Define o intervalo (em horas) da execução da limpeza de memória residual
HoraLimparMemoriaResidual=2
[ConexaoNome_Default]
# Indica o nome da conexão padrão da API
Conexao=CLOVIS
# Indica o nome do usuário da conexão padrão da API. O nome do usuário deve estar encodado usando a ferramenta de encode e decode de senhas.
UserIDAPI=330370080971721821921721821921721821921721821921721821921721821921721821921620580960470881921721821921721821921721821921721821921721821921721821921721720250
# Indica a senha do usuário da conexão padrão da API. O nome do usuário deve estar encodado usando a ferramenta de encode e decode de senhas.
SenhaAPI=330370080971721821921721821921721821921721821921721821921721821921721821921620580960470881921721821921721821921721821921721821921721821921721821921721720250
5.1 - Definições
Parâmetro | Significado |
---|
ArquivoConexoes | Refere-se ao caminho do arquivo de conexões do banco de dados, neste caso, o Principal.conexoes. |
UrlBase | Define a porta do servidor do ViasoftServerAgroApi. |
6 - ViasoftServerAgroJobs.conf
Caso não exista, esse arquivo deve ser criado na pasta Viasoft/Server/Agro. Onde deve conter a estrutura abaixo:
Arquivo de configuração do ViasoftServerAgroJobs.conf
#{*******************************************************}
#{ }
#{ Arquivo de Configuração do Serviço de Agro Api }
#{ }
#{ Copyright(c) 1995-2022 Viasoft Tecnologia }
#{ }
#{*******************************************************}
[Conexoes]
# Configura o nome de arquivo de conexões a ser usado pelo serviço.
# Deixe comentado para usar o padrão ViasoftServerAgroApi.conexoes
# Exemplos:
ArquivoConexoes={AppPath}\Principal.conexoes
;ArquivoConexoes=.\Principal.conexoes
[Portas]
# Configura a url base a ser usada para acessar e consumir os serviços e endpoints.
# O padrão é http://+:2001/viasoftserver que representa o acesso ao computador localhost e porta 2001.
UrlBase=http://+:2003/viasoftserver
[Pool_Config]
# Número de conexões com o banco de dados que serão criadas quando o primeiro cliente se conectar.
# O padrão é 1 conexão
MinConnections=1
# Número máximo de conexões que serão criadas no pool.
# Se este limite for atingido, a tentativa de obter uma nova conexão irá gerar um log de erro no serviço.
# O padrão é 10 conexões
MaxConnections=100
# Número de conexões que serão criadas a cada vez que for necessário expandir o pool.
# O padrão é 1 conexão
Incremento=1
# Tempo máximo que uma conexão pode ficar aberta sem uso. Evita o acumulo de conexões ativas em desuso
# que acabam consumindo recursos do servidor.
# O padrão é 1 minuto. Deixe 0 para desativar.
ConnectionTimeoutDB=1
ConnectionTimeout=30
# Tempo máximo (em minutos) que uma conexão pode ficar livre sem uso no Pool. Evita o acumulo de conexões ativas.
# 0=desativado
# Padrão é 0.
TimeoutConexaoLivre=0
# Grava no banco de dados (nas variáveis de sessão) o código do usuário logado para cada conexão criada no pool.
# 0-Não;1-Sim
# Padrão é 0.
UserIdSession=0
[Debug]
# Nível de detalhe das mensagens a ser geradas no log em arquivo. Podem ser configurados valores de 0 a 9.
# 0-Nenhuma; 1-Apenas erros; 9-Mais detalhado
# O padrão é 1.
DebugFileLevel=1
# Nome e caminho do arquivo onde devem ser os logs.
# Exemplo: Z:\Viasoft\App\xdata\server_DATA.log
DebugFile=C:\D\ZREDE\Z\Viasoft\App\LOG\server_DATA.log
# Informa se deve ser mantido um arquivo de log separado para cada dia.
# Esta opção substitui a palavra DATA no nome do arquivo pela data.
# Exemplo: server_DATA.log > server_2022-01-01.log
# 0-Desativado; 1-Ativado
DebugFileDiario=1
# Limpar o arquivo de log a cada execução. Se desativado o arquivo de log pode ficar muito grande.
# 0-Desativado; 1-Ativado
DebugClear=0
# Informa quando tempo o Nível de detalhes deve ficar habilitado. Possíveis configurações:
# 0 - Até reiniciar o servidor;
# 1 - 10 minutos
# 2 - 30 minutos
# 3 - 2 horas
# 4 - 4 horas
# 5 - 12 horas
# 6 - 24 horas
# O padrão é -1 (Desabilitado).
DebugTimer=-1
# Nome e caminho do arquivo onde devem ser salvas as requisições que forem feitas. Deve ser usada apenas para debug.
DebugFileRequests=C:\D\ZREDE\Z\Viasoft\App\LOG\requests.log
[DebugSQL]
# Informa se deve ser gerado log das SQLs.
# 0-Desativado; 1-Ativado
DebugSQLmonitorar=0
# Nome e caminho do arquivo onde devem ser os logs de SQL.
# Exemplo: D:\Viasoft 729\Server\AgroXE\Log\
DebugSQLFile=C:\D\ZREDE\Z\Viasoft\App\LOG\SQL_DATA.log
# Limpar o arquivo de log a cada execução. Se desativado o arquivo de log pode ficar muito grande.
# 0-Desativado; 1-Ativado
DebugSQLclear=0
[Auditoria]
Capacidade=0
BatchCriar=
AuditElasticSearch=N
AuditElasticSearchIp=127.0.0.1
AuditElasticSearchPorta=8585
AuditElasticSearchFilaPorta=61613
AuditElasticSearchNotificaoFalhaPermiteLogin=0
AuditElasticSearchNotificaoFalhaNotificar=1
AuditElasticSearchNotificaoFalhaNotificarLog=1
AuditElasticSearchNotificaoFalhaNotificarEMail=0
[Notificacoes]
NotificacaoAtiva=0
SMTPHost=204255255253254055002
SMTPPorta=587
SMTPUsuario=204255255253254055002
SMTPSenha=204255255253254055002
SMTPUsaAutenticacao=1
SMTPAutenticacao=-1
SMTPAutVerSSL=-1
SMTPAutTSLTP=-1
RemetenteNome=204255255253254055002
Remetente=204255255253254055002
SMTPPrefixoAssunto=840671211900192131310481511101210231511700790390190191511501700792220131801011401510861900990191410860
NotificacaoIntervalo=5
[Avancado]
# Exporta a lista de bancos de dados para o cliente.
# Se estiver marcado o cliente recebe uma lista com o nome das conexões disponíveis. Caso contrário ele deve informar o nome da conexão que deseja usar.
# Ideal em Data Centers compartilhados
# 0-Não;1-Sim
# Padrão é 0.
ExportarListaBD=1
[NFe]
URL=
TIMEOUT=600
# Salva os xmls das NFes na pasta/caminho indicado
PathXML=
# Salvar os xmls das NFe.
# 0-Não;1-Sim
# Padrão é 0.
SalvarXML=0
# Nome da conexão MD-e automático
CONEXAOMDE=
[CTe]
# Salva os xmls dos CTes na pasta/caminho indicado
PathXMLCTE=
# Salvar os xmls dos CTes.
# 0-Não;1-Sim
# Padrão é 0.
SalvarXMLCTE=0
[NFSe]
DIRETTRANSMITIR=
DIRETAUTORIZADOS=
DIRETERROS=
TIMEOUT=20
[DFe]
# Deve-se ligar o nome da conexao com o o banco de dados com o sistema para que o servidor DF-e funcione corretamente
# Os sistemas disponíveis são: AGRO, AUTOCML, CONSTRUSHOW, MERCADO, PETROSHOW
# Exemplo abaixo
# CONEXAO_ORACLE=AGRO
[Console_Abast]
# Nome da conexão do abastecimento
# Padrão em branco
Conexao=
# Timer de abastecimentos (em segundos)
Timer=0
# Timer de statuso de bombas e bicos (em segundos)
TimerStatusBombaBico=0
[Portas]
PortServer=300
PortServerRest=301
PortMsgUser=311
KeepAliveEnabled=1
KeepAliveTime=1
PortComAgente=9099
[Agendador_Tarefas]
# Indica se o agendador de tarefas está ativo ou não: 0-Não; 1-Sim
AgendadorTarefasAtivo=1
# Define o intervalo (em minutos) da execução do Job que efetiva os procedimentos genericos do servidor.
TempoJobGeral=5
# Ativa a limpeza de memória residual: 0-Não;1-Sim
LimparMemoriaResidual=0
# Define o intervalo (em horas) da execução da limpeza de memória residual
HoraLimparMemoriaResidual=2
[ConexaoNome_Default]
# Indica o nome da conexão padrão da API
Conexao=CLOVIS
# Indica o nome do usuário da conexão padrão da API. O nome do usuário deve estar encodado usando a ferramenta de encode e decode de senhas.
UserIDAPI=330370080971721821921721821921721821921721821921721821921721821921721821921620580960470881921721821921721821921721821921721821921721821921721821921721720250
# Indica a senha do usuário da conexão padrão da API. O nome do usuário deve estar encodado usando a ferramenta de encode e decode de senhas.
SenhaAPI=330370080971721821921721821921721821921721821921721821921721821921721821921620580960470881921721821921721821921721821921721821921721821921721821921721720250
6.1 - Definições
Parâmetro | Significado |
---|
ArquivoConexoes | Refere-se ao caminho do arquivo de conexões do banco de dados, neste caso, o Principal.conexoes. |
UrlBase | Define a porta do servidor do ViasoftServerAgroJobs. |
Instalação dos Serviços TMS
Inicialmente baixar os executáveis ViasoftServerAgroX.exe , ViasoftServerAgroJobs.exe e ViasoftServerAgroApi.exe e colocar na pasta Viasoft/Server/Agro. Após realizado esse processo o mesmo esta apto para realizar a instalação pelo CMD
01. Instalando o Serviço ViasoftServerAgroX
Para o servidor ViasoftServerAgroX basta executar o seguinte comando no CMD:
sc create <nome do serviço> binPath= "<camimhho do servico> <nome do serviço>"
Parâmetro | Significado |
---|
<nome do serviço> | Refere-se ao Nome do Serviço que ira ser utilizado para o ViasoftServerAgroX , por Padrão deve ser utilizado o nome ViasoftAgroServer |
<camimhho do servico> | Define o caminho da pasta a onde se encontra o ViasoftServerAgroX.exe |
Exemplo:
sc create ViasoftAgroServer binPath= "C:\Viasoft\Server\Agro\ViasoftServerAgroX.exe ViasoftAgroServer"
02. Instalando o Serviço ViasoftServerAgroJobs
Para o servidor ViasoftServerAgroJobs basta executar o seguinte comando no CMD:
sc create <nome do serviço> binPath= "<camimhho do servico> <nome do serviço>"
Parâmetro | Significado |
---|
<nome do serviço> | Refere-se ao Nome do Serviço que ira ser utilizado para o ViasoftServerAgroX , por Padrão deve ser utilizado o nome ViasoftServerAgroJobsService |
<camimhho do servico> | Define o caminho da pasta a onde se encontra o ViasoftServerAgroJobs.exe |
Exemplo:
sc create ViasoftServerAgroJobsService binPath= "C:\Viasoft\Server\Agro\ViasoftServerAgroJobs.exe ViasoftServerAgroJobsService"
03. Instalando o Serviço ViasoftServerAgroApi
Para o servidor ViasoftServerAgroApi basta executar o seguinte comando no CMD:
sc create <nome do serviço> binPath= "<camimhho do servico> <nome do serviço>"
Parâmetro | Significado |
---|
<nome do serviço> | Refere-se ao Nome do Serviço que ira ser utilizado para o ViasoftServerAgroX , por Padrão deve ser utilizado o nome ViasoftServerAgroApiService |
<camimhho do servico> | Define o caminho da pasta a onde se encontra o ViasoftServerAgroApi.exe |
Exemplo:
sc create ViasoftServerAgroApi binPath= "C:\Viasoft\Server\Agro\ViasoftServerAgroApi.exe ViasoftServerAgroApi"
04. Removendo Serviços
Caso houver a necessidade de deletar algum serviço basta utilizar esse comando no CMD
remove-service "nome do serviço"
Inicializando o Sistema pelo TMS
Os executáveis que são compatíveis com o TMS no seu nome ira conter um 'X' por exemplo AgroX, ExpImpAgroX, FinAgroX e etc. Caso não possuir estes executáveis basta baixa-los nas pastas padrões do Agro
Por fim, executar a aplicação escolhida, selecionar a conexão XDATA criada anteriormente
Ao informar XDATA, no campo Nome da Conexão será apresentado as conexões que foram informadas no arquivo viasoft.Agro.conexoes
Assim informando Usuário e senha , com isso podendo utilizar o sistema normalmente.