Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Manual com orientações de instalação e configuração do processo ILSVW. (Integração Elsa, Saga) |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Esse processo se destina a todas as concessionárias VW que utilizam o Bravos. |
Painel | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
Requisitos de Hardware/Sistema operacionalAs máquinas de integração que ficarão junto a cada BtacBox, atualmente cada DN precisa de sua maquina de integração, devem atender os seguintes requisitos:
a. Mínimo um processador dual core, 2 GB de memória RAM e 100 GB de espaço disponível no disco rígido; b. Acesso ao DMS-Backbone, através da rede do Cisco; c. Acesso via rede/internet ao servidor de integração.
a. Mínimo um processador dual core, 2 GB de memória RAM e 100 GB de espaço disponível no disco rígido; b. Acesso ao Banco de dados do sistema BRAVOS, através de uma rede local. Cisco/BtacboxA BtacBox é o hardware responsável pela comunicação entre o sistema de integração VW e o sistema da própria VW na Alemanha. Cada revenda possui uma Cisco, que fornece acesso a sistemas como o ElsaPro e o SAGA/2, baseado nisso, para que uma estação de trabalho possa executar o ElsaPro, por exemplo, é necessário que ela esteja na mesma rede do Cisco. Estrutura da redeImportante: As máquinas de integração precisam ter acesso direto a sua respectiva BtacBox, já o servidor de integração não precisa em nenhum momento acessar a BtacBox. Cenário 1 - Servidor localO diagrama abaixo representa a estrutura onde o banco de dados está na mesma rede local de uma das revendas, as demais revendas acessam o banco de dados de forma remota. Cenário 2 - Servidor em nuvemO diagrama abaixo representa a estrutura onde o banco de dados está em uma estrutura separada, como por exemplo, um DataCenter. Neste caso, todas as revendas acessam o banco de dados de forma remota.
Programas/Arquivos necessáriosPara realizar o download dos arquivos e programas necessários, basta acessar ao DVI e realizar o download do pacote conforme a versão do seu banco de dados. Link: DVI - Liberações Linx DMS | DMS Automotivo - Automotivo - Linx Share |
Painel | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Nova instalação - Servidor Integração VWExtraindo arquivosApós realizado o download do pacote de sistema de integração VW no DVI, extrair o conteúdo da pasta dentro do zip no diretório C:\VW\, após extraído, crie a pasta C:\VW\Services\ e C:\VW\AtualizaDN. Instalando ApacheAcessar ao diretório C:\VW\Apache e realizar a instalação do Apache 2.2 (httpd-2.2.25-win32-x86-no_ssl.msi), realizar a instalação padrão, clicando em Next até que a instalação seja finalizada, após isso acessar diretório de configuração do Apache 2.2: C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf, faça um backup do arquivo httpd.conf, após isso edite o arquivo original e localize as seguintes informações:
Após realizado a configuração do Apache, salve o arquivo e reinicie o serviço através do Gerenciador de Tarefas do Windows.
Após isso copiar o arquivo <ILCLinxCollector.dll>, existe na pasta C:\VW para a pasta C:\VW\Services\, após isso tentar acessar à URL: http://localhost:8080/LinxDms/ILCLinxCollector.dll Instalando serviçoCriar o diretório C:\VW\AtualizaVW e copiar todo o conteúdo do pacote de instalação para esta pasta. Renomear o arquivo <Linx DMS<Apollo_Exemplo.ini> para <Apollo.ini>, abrir o arquivo e informar o diretório conforme abaixo:
Renomear o arquivo <ConexaoServidor_Exemplo.dat> para <ConexaoServidor.dat>, editar o arquivo e ajustar os parâmetros conforme conexão do banco de dados da revenda (Oracle ou SQL Server): Bloco de código | | |||||||||||||||
| ||||||||||||||||
Bloco de código | title |
Bloco de código | ||
---|---|---|
| ||
[BANCODADOS]=ORACLE
[USUARIO_ORACLE]=CNP
[DATABASE]=AUTO
[PORTA]=INTEGRATIONLAYER:234
[DIRATUALIZACAO]=c:\apollo\arquivo\
[DIRLOG]=c:\temp\
//Porta onde está rodando o VerificaServer
[PORTA_VERIFICADOR]=210
//S->Serviço e A->Aplicação
[INTEGRACAO_VW]=S |
Bloco de código | ||
---|---|---|
| ||
[BANCODADOS]=SQLSERVER
[DATABASE]=192.168.3.31:BRAVOS
[PORTA]=INTEGRATIONLAYER:234
[DIRATUALIZACAO]=c:\apollo\arquivo\
[DIRLOG]=c:\temp\
//Porta onde está rodando o VerificaServer
[PORTA_VERIFICADOR]=210
//S->Serviço e A->Aplicação
[INTEGRACAO_VW]=S |
Aviso | ||
---|---|---|
| ||
Caso o computador também seja um servidor de 3 Camadas, será necessário avaliar se as portas informadas nas tag [PORTA] e [PORTA_VERIFICADOR] estão disponíveis, caso contrário será necessário utilizar uma porta não utilizada por nenhum serviço. |
Renomear o arquivo <ConexaoExemplo.dat> para <Conexao.dat>, editar o arquivo para que seja informado o IP do computador serviço de integração:
Bloco de código | ||
---|---|---|
| ||
[VERSAOEXE]=1.0.0.0 [DIRATUALIZACAO]=C:\Temp\ [BANCODADOS]=DATASNAP [DATABASE]=127.0.0.1:234 |
Na pasta C:\VW\AtualizaVW\ executar o programa <AtuILSServer.exe> como administrador, após isso clicar em Instalar/Atualizar. (1) Ajustar/informar os parâmetros da tela conforme as instruções abaixo:
- No campo <Pasta de atualização onde serão copiados os arquivos que ficarão junto a BTacBox>, informar o diretório para onde serão copiados os arquivos de instalação/atualização por DN. Será deste diretório que cada DN (máquina de integração) irá buscar os arquivos para instalação/atualização;
- No campo <Pasta dos programas servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão os programas no servidor de integração, por padrão esse diretório é o C:\VW;
- No campo <Pasta dos serviços web servidores (mesma rede do servidor de Banco de Dados)>, informar o diretório onde ficarão as dlls que serão executadas como serviço web no servidor de integração, por padrão esse diretório é o C:\VW\Services;
- No campo <Tipo Servidor de Aplicação>, selecionar a opção serviço;
- No campo <Tipo Serviço Web>, selecionar Apache;
- No campo <Script a ser rodado>, selecionar a opção. <AtualizaIntegracaoVWCompleta.exe> (2);
- Após isso clicar para continuar (3) e aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso;
Aviso | ||
---|---|---|
| ||
Caso a revenda utilize uma senha de conexão ao banco de dados diferente da senha padrão Linx, é necessário copiar o arquivo senhabd.dat que a revenda utiliza para dentro da pasta C:\VW\Services\. |
Nova instalação - Máquina de integração
Configurando o Bravos
Acessar ao Bravos e abrir o menu FábricaVW - Parâmetros aba Geral, informar o número do DN da revenda com 5 dígitos (preencher com 0 a esquerda).
Ir a aba Integrações e preencher os campos conforme abaixo:
- No campo "URL abertura ElsaPro", informar: https://grp.cpn.vwg/elsapro/elsaweb/ctr/DP/loadJobFromExternal?DMS_ORDER_ID=:CONTATO&JOB_DATE=:DTA_CONTATO
- No campo <Tipo de Integração SAGA/2>, informar qual ambiente que será utilizado (Produção);
- Nos campos do grupo <Incluir serviço do ElsaPro>, para os serviços incluídos pelo ElsaPro em um atendimento que já tem OS gerada, informe se estes serviços serão incluídos diretamente na OS ou em um Orçamento;
- Nos campos do grupo <Inclusão de Serviços>, informe os dados necessários para a inclusão de novos serviços vindos dos sistemas VW;
- No campo <Diretório de atualização dos arquivos por DN>, informar o diretório de onde serão copiados os arquivos de instalação/atualização por DN. Esse diretório tem que ser visível pela máquina de integração e também pelo servidor de integração;
- No campo <Diretório de programas por DN>, informar o diretório onde ficarão os programas na máquina de integração, por padrão esse diretório é o C:\VW.
- No campo <Diretório de serviços web por DN>, informar o diretório onde ficarão as dlls que serão executadas como serviço web na máquina de integração, por padrão esse diretório é o C:\VW\Services.
- No campo <Tipo Serviço Web>, informar o servidor web utilizado: Apache.
Cenário
Após realizado toda a parametrização para o serviço que irá comunicar com o banco de dados é necessário que seja realizado o registro do DN da revenda para que a comunicação se inicie. Neste parte existe um ponto que precisa ser verificado, caso a revenda tenha um servidor local, onde a maquina servidora também é uma uma maquina de integração (cenário 1), basta seguir o procedimento para servidor local, caso a revenda possua o servidor em nuvem (cenário 2) e filiais, basta seguir o tópico servidor remoto.
Informações | ||
---|---|---|
| ||
Para parametrizar a máquina de integração é necessário que ela se comunique com a btacbox. |
Servidor Local
Na máquina onde esta instalado o servidor de integração executar o programa <C:\VW\AtualizaVW\AtuILSDN.exe> como administrador, clicar no botão Instalar/Atualizar, na tela que será apresentada informar o número DN da revenda (informar o número do DN com 5 dígitos).
Após seguir as parametrizações iniciais, será exibido em tela um campo para informar o endereço do servidor web, informar o endereço IP do Servidor de integração VW.
Em seguida será exibido duas telas conforme abaixo, nela informe novamente o IP do computador que é o Servidor de integração VW, neste ponto está sendo instalado o serviço de comunicação e o monitor de integração.
Aviso | ||
---|---|---|
| ||
Caso tenha configurado a porta diferente, devido à existir um servidor de 3 camadas na mesma máquina, deve ser informada porta parametrizada no arquivo C:\VW\ConexaoServidor.dat |
Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso, partiremos agora para a configuração da DMS-Backbone
Servidor remoto
No servidor que se encontra na nuvem, zipar a pasta C:\VW e extrair no computador que será a maquina de integração VW e executar o programa <C:\VW\AtualizaVW\AtuILSDN.exe> como administrador, clicar no botão Instalar/Atualizar, na tela que será apresentada informar o número DN da revenda (informar o número do DN com 5 dígitos).
Após seguir as parametrizações iniciais, será exibido em tela um campo para informar o endereço do servidor web, informar o endereço IP do Servidor de integração VW que se encontra na nuvem.
Em seguida será exibido duas telas conforme abaixo, nela informe novamente o IP do computador que é o Servidor de integração VW que se encontra na nuvem, neste ponto está sendo instalado o serviço de comunicação e o monitor de integração.
Aviso | ||
---|---|---|
| ||
Caso tenha configurado a porta diferente, devido à existir um servidor de 3 camadas na mesma máquina, deve ser informada porta parametrizada no arquivo C:\VW\ConexaoServidor.dat |
Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso, partiremos agora para a configuração da DMS-Backbone
Configurando DMS-Backbone
O DMS-Backbone é o software que roda na BtacBox, através deste programa é necessário configurar alguns itens do equipamento, seguindo a documentação da Volkswagen (IT MASS 12, disponível no Portal Rede VW).
Para acessar ao DMS-Backbone é necessário anotar o endereço IP que é exibido no visor da btacbox, abrir o navegador e informar http://IP-BTAC:81, a senha padrão do equipamento é dms-BB4, após acessado ao sistema, buscar no menu lateral Services (1), para apontar os serviços de configuração para a maquina de integração do DN configurado. Caso ja exista o serviço informado para um IP, basta clicar no nome do serviço do quadro (2) e alterar IP no quadro inferior (3).
Abaixo estão os serviços da tela acima, para facilitar a operação de cadastro e permitir copiar do pdf e colar no DMS-BackBone.
ServiceName | Target Adress | Description |
---|---|---|
BusinessPartnerData | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/BusinessPartnerData | Linx BusinessPartnerData |
ClaimProcessing | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/ClaimProcessing | Linx ClaimProcessing |
CustomerVehicleData | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/CustomerVehicleData | Linx CustomerVehicleData |
ShopData | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/ShopData | Linx ShopData |
SparepartOrder | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/SparepartOrder | Linx SparepartOrder |
WorkshopOrder | http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll/WorkshopOrder | Linx WorkshopOrder |
Após configuração dos serviços é necessário verificar se o MSH está ativo. Para isso basta acessar ao menu MSH-Activation.
Informações | ||
---|---|---|
| ||
Caso não exista o número do DN da revenda registrado, verificar o procedimento de ativação no documento disponível no Portal Rede VW - Download - IT_MASS_12, qualquer dúvida sobre a ativação desta funcionalidade, precisa ser verificado junto a Volkswagen. |
Após realizado a configuração dos serviços e MSH, acessar ao menu System test clicar no botão Run All tests, que se encontra no final da página, e aguardar a finalização.
Aviso | ||
---|---|---|
| ||
Tanto na máquina de integração, quanto no servidor de integração a porta 8080 é recomendável que firewall Windows esteja desativado, caso não possa desativar, segue instrução para liberação: <LINK SHARE AREA CLIENTE>. |
Informações | ||
---|---|---|
| ||
Segue abaixo a lista dos serviços relevantes ao sistema de integração e uma breve descrição do que é cada serviço: BusinessPartnerData – Serviço de integração Linx responsável por enviar os dados do cliente. Utilizado pelo ElsaPro, Reserve e Etka (disponível no arquivo ILCLinxCollector.dll, serviço web). |
Configuração do ILConfig
Acessar à maquina de integração da revenda abrir o programa C:\VW\ILConfig.exe, acessar ao menu Configurações > ListenerN / Sender > WebServices, cadastrar os seguintes WebServices, onde o número do DN possui 5 dígitos, conforme exemplo abaixo.
Informações | ||
---|---|---|
| ||
Observação: Alterar o IP dos endereços pelo IP da Btac-BOX. Este cadastro é por DN, ou seja, cada revenda terá o seu conjunto de WebServices. Importante: As máquinas de integração precisam ter acesso direto a sua respectiva BtacBox, já o SERVIDOR de integração não precisa em nenhum momento acessar a BtacBox. |
Serviço | DN | URL |
---|---|---|
AliveTest | 0XXXX | http://IP_BTACBOX:81/OrderServiceCentral.bb |
FishInfoBox -> AliveTest | 0XXXX | http://IP_BTACBOX:81/FishInfoBox.bb |
FishInfoBox -> SubscriptionData | 0XXXX | http://IP_BTACBOX:81/FishInfoBox.bb |
OrderService -> AliveTest | 0XXXX | http://IP_BTACBOX:81/OrderServiceCentral.bb |
OrderService -> SubscriptionData | 0XXXX | http://IP_BTACBOX:81/OrderServiceCentral.bb |
WarrantyProcessing -> ProcessOrder | 0XXXX | http://IP_BTACBOX:81/MSH.bb |
WarrantyProcessing -> SetClaimStatus | 0XXXX | http://IP_BTACBOX:81/MSH.bb |
WarrantyProcessing -> DeleteOrder | 0XXXX | http://IP_BTACBOX:81/MSH.bb |
OrderServiceParts -> SubscriptionData | 0XXXX | http://IP_BTACBOX:81/OrderServiceParts.bb |
Aviso | ||
---|---|---|
| ||
Caso o IP da btacbox não seja fixo, o IP muda a cada vez que o equipamento é reiniciado, é necessário acionar a Disal solicitando definir um IP fixo no equipamento. Contato: [email protected] |
Após cadastrar cada um dos endereços WebServices, selecionar um por um e clicar no botão "Testar". Depois de alguns segundos clicar sobre o botão "Retorno Teste" para verificar o resultado do teste, a coluna Teste deve ficar com a palavra OK, Caso o retorno seja a palavra ERRO (será gravado um arquivo com o xml de retorno na pasta C:\VW, com o nome RetTesteWebService*.xml, onde o * são as informações de data e hora de gravação), o endereço do WebService e a comunicação entre a máquina de integração do DN e a BtacBox devem ser verificados.
Acessar ao menu Cadastro - Parâmetros do Serviço e preencher os campos conforme orientado abaixo:
- Gera arquivo Log: Marcar caso queira que seja gravado os arquivos de log.
- Diretório de Log: Informar um endereço local para gravação do log. Ex.: c:\temp\
- Gera apenas XML dos WebServices: Se estiver marcado, não vai enviar nenhum xml de integração para o BtacBox. Nunca marcar em ambientes de produção.
- Strings Indicativas Erro: (colocar entre separadores <>): Informar sempre - <EXCEPTION><ERROR >< ERROR>
- Diretório de trabalho: Informar um endereço local para gravação dos arquivos de trabalho. Ex.: c:\temp\trab\
- Tempo Listener (em segundos): Informar o intervalo de tempo para o serviço verificar se tem algo para enviar à BtacBox. Tempo sugerido de 10 segundos.
- Tempo Refresh Monitor (em segundos): Intervalo de verificação do programa MonitorILS.exe. Tempo sugerido de 15 segundos.
- ATENÇÃO: Os caminhos informados nos campos "Diretório de Log" e "Diretório de trabalho" precisam existir na máquina de integração que fica junto a BTacBox.
- Nos campos <Enviar ElsaPro>,<Enviar Reserve> e <Enviar Etka> é possível configurar manualmente para enviar ou não as movimentações realizadas no BRAVOS.
Na aba Monitor ListnerX, cadastrar todos os DNs que deverão ser monitorados pelo MonitorILS, informando a url da dll, conforme exemplo que segue (o endereço abaixo se refere ao IP da máquina de integração por DN): http://IP_MAQUINA_INTEGRACAO:8080/LinxDms/ILCLinxListnerX.dll
Configurando o ETKA
Para realizar a configuração do ETKA basta seguir a documentação: [ETKA] Integração Bravos x ETKA, onde tudo referente a esta integração será tratada nela.
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Atualização Integração VWSerá explicado agora como realizar a atualização dos serviços de Integração VW, para caso realize a troca de versão ou sanar algum problema, esse item do manual é válido apenas para instalações já existentes. Para isso realizar acesso ao menu Fábrica VW - Parâmetros aba Integrações, nesta tela verificar o diretório de atualização configurado.
Na maquina servidora de integração, criar o diretório C:\VW\AtualizaDN e extrair o pacote que será atualizado, copiar o arquivo C:\VW\ConexaoServidor.dat para a pasta C:\VW\AtualizaVW, em seguida executar o programa AtuILSServer.exe como administrador clicar em Instalar/Atualizar e selecionar a opção AtualizaIntegracaoVWExpressa.exe. Aguardar até a mensagem Instalação / Atualização realizada com sucesso! apareça na barra de progresso.
|
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Exportação/Importação da configuração
|
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Monitor de Serviços de Integração (MonitorILS.exe)
|
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
VerificaServerO VerificaServer.exe é utilizado para melhorar a estabilidade do servidor de integração e também tornar auto gerenciável o processo de reinicialização diária do serviço: Linx - Servidor de Aplicação Camada de Integração Volkswagen, para realizar a configuração, basta seguir a documentação: Integração VW | VerificaServer |
Painel | ||||||
---|---|---|---|---|---|---|
| ||||||
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Nacional, através do site cliente.linx.com.br. |