KnappGateways Services Versão 1.0 George Paoli - Drogaria Araujo S.A 08/02/2017
HJ -> KNAPP 1 WmsToWcsGateway Service 3 1.1 Fluxo................................................... 5 1.2 Configuração............................................... 6 1.3 Instalação/Desintalação......................................... 6 1.4 Execução................................................. 7 1.5 Monitoramento.............................................. 7 2 WcsToWmsGateway Service 9 2.1 Fluxo................................................... 11 2.2 Configuração............................................... 12 2.3 Instalação/Desintalação......................................... 12 2.4 Execução................................................. 13 2.5 Monitoramento.............................................. 13 i
ii
Detalhes da configuração, instalação, execução e monitoramento dos serviços criados para fazer o trabalho de Gateway entre o WCS KNAPP e o WMS HighJump, utilizados no CD da Drogaria Araujo. Aviso: IMPORTANTE: Antes de iniciar qualquer um dos serviços, é necessário desligar as interfaces do WMS Hight Jump, caso estejam ligadas. HJ -> KNAPP 1
2 HJ -> KNAPP
CAPÍTULO 1 WmsToWcsGateway Service Serviço responsável por receber as mensagens do WMS HighJump e enviar para o WCS KNAPP 3
4 Capítulo 1. WmsToWcsGateway Service
1.1 Fluxo 1.1. Fluxo 5
1.2 Configuração Requisitos mínimos: Windows Server 2012 R2-64bit.NET Framework v4.6 4GB de RAM Intel Xeon 2.60GHz Ambientes e Servidores: Servidor/IP Função Ambiente WINPKNAPPGW Servidor de Aplicação PRODUCAO WINDHTKNAPPGW Servidor de Aplicação HOMOLOGACAÇÃO???\HCDNHJS Servidor de Banco PRODUCAO WINDHTSQLCDN02\HCDNHJS Servidor de Banco HOMOLOGACAÇÃO Localização dos arquivos no servidor de aplicação: C:\Servicos\WmsToWcsGateway Parâmetros disponíveis no App.config: Parâmetro Descrição Valor Default connectionstring/default de conexão com banco Data Source=SERVIDOR DB;Initial de dados Catalog=AAD;Persist Security Info=True;User ID=USUARIO;Password=SENHA; appsettings/wcs-ip Endereço IP do servidor 10.85.243.1 KNAPP appsettings/wcs-port Porta TCP/IP que a KNAPP 9801 recebe as mensagens do WMS appsettings/sleep-verificar-servico-habilitado Tempo, em segundos, de 10000 espera para verificar novamente se o serviço está habilitado appsettings/sleep-verificar-nova-mensagem Tempo, em segundos, de 10000 espera para verificar se existe uma nova mensagem Nota: É necessário efetuar o stop e start do serviço após qualquer ajuste nas configurações 1.3 Instalação/Desintalação Instalar: C:\Servicos\WmsToWcsGateway\WmsToWcsGateway.exe install Desinstalar: C:\Servicos\WmsToWcsGateway\WmsToWcsGateway.exe uninstall 6 Capítulo 1. WmsToWcsGateway Service
Nota: Execute o prompt como ADMINISTRADOR 1.4 Execução Aviso: IMPORTANTE: Antes de iniciar o serviço, é necessário desligar a interface do WMS Hight Jump, caso esteja ligada. Start: C:\Servicos\WmsToWcsGateway\WmsToWcsGateway.exe start Stop: C:\Servicos\WmsToWcsGateway\WmsToWcsGateway.exe stop Nota: Execute o prompt como ADMINISTRADOR 1.5 Monitoramento Toda troca de mensagens é registrada em arquivo texto de log. Localização do log em arquivo texto: C:\Servicos\WmsToWcsGateway\logs\YYYY-MM-DD.log É possível visualizar o log em tempo real por meio do Sentiel Viewer: 1. Abra o Sentinel e crie uma nova session 2. Escolha o provider NLog Viewer Provider 3. Em seguida o protocolo UDP e porta 9999 Nota: 1. Detalhes de configuração do mecanismo de log estão localizados no arquivo NLog.config. Após qualquer ajuste é necessário efetuar o stop e start do serviço 2. Limpeza do log: Arquivos com mais de uma semana, serão excluídos 1.4. Execução 7
8 Capítulo 1. WmsToWcsGateway Service
CAPÍTULO 2 WcsToWmsGateway Service Serviço responsável por receber as mensagens do WCS KNAPP e enviar para o WMS HighJump 9
10 Capítulo 2. WcsToWmsGateway Service
2.1 Fluxo 2.1. Fluxo 11
2.2 Configuração Requisitos mínimos: Windows Server 2012 R2-64bit.NET Framework v4.6 4GB de RAM Intel Xeon 2.60GHz Ambientes e Servidores: Servidor/IP Função Ambiente WINPKNAPPGW Servidor de Aplicação PRODUCAO WINDHTKNAPPGW Servidor de Aplicação HOMOLOGACAÇÃO???\HCDNHJS Servidor de Banco PRODUCAO WINDHTSQLCDN02\HCDNHJS Servidor de Banco HOMOLOGACAÇÃO Localização dos arquivos no servidor de aplicação: C:\Servicos\WcsToWmsGateway Parâmetros disponíveis no App.config: Parâmetro Descrição Valor Default connectionstring/default de conexão com banco de dados Data Source=SERVIDOR DB;Initial Catalog=AAD;Persist Security Info=True;User ID=USUARIO;Password=SENHA; appsettings/wcs-ip Endereço IP do servidor 10.85.243.1 KNAPP appsettings/wcs-port Porta TCP/IP que a KNAPP 9802 envia as mensagens para o WMS appsettings/sleep-verificar-servico-habilitado Tempo, em segundos, de 10000 espera para verificar novamente se o serviço está habilitado Nota: É necessário efetuar o stop e start do serviço após qualquer ajuste nas configurações 2.3 Instalação/Desintalação Instalar: C:\Servicos\WcsToWmsGateway\WcsToWmsGateway.exe install Desinstalar: C:\Servicos\WcsToWmsGateway\WcsToWmsGateway.exe uninstall Nota: Execute o prompt como ADMINISTRADOR 12 Capítulo 2. WcsToWmsGateway Service
2.4 Execução Aviso: IMPORTANTE: Antes de iniciar o serviço, é necessário desligar a interface do WMS Hight Jump, caso esteja ligada. Start: C:\Servicos\WcsToWmsGateway\WcsToWmsGateway.exe start Stop: C:\Servicos\WcsToWmsGateway\WcsToWmsGateway.exe stop Nota: Execute o prompt como ADMINISTRADOR 2.5 Monitoramento Toda troca de mensagens é registrada em arquivo texto de log. Localização do log em arquivo texto: C:\Servicos\WcsToWmsGateway\logs\YYYY-MM-DD.log É possível visualizar o log em tempo real por meio do Sentiel Viewer: 1. Abra o Sentinel e crie uma nova session 2. Escolha o provider NLog Viewer Provider 3. Em seguida o protocolo UDP e porta 9998 Nota: 1. Detalhes de configuração do mecanismo de log estão localizados no arquivo NLog.config. Após qualquer ajuste é necessário efetuar o stop e start do serviço 2. Limpeza do log: Arquivos com mais de uma semana, serão excluídos Localização da documentação de referência utilizada, fornecida pela KNAPP, no repositório: $/Gestao do Negocio/.Net/KnappGateway/Arquivos/R132A_DROGARIA_ARAUJO_BeloHorizonte_IS_V1-7_bra.pdf Localização do código fonte, dos serviços, no repositório: $/Gestao do Negocio/.Net/KnappGateway/Fontes Localização do código fonte, desta documentação, no repositório: $/Gestao do Negocio/.Net/KnappGateway/Arquivos/Docs 2.4. Execução 13