Linx DMS Services
Manual de Instalação
Data: 26/10/2016
Autor: Distribuição Linx DMS
[email protected]
Área: P&D DMS Porto Alegre
ÍNDICE
Índice separator braces
Linx DMS Services
O Linx DMS Servicesé um serviço WebService que faz a interação do Linx DMS Apollo/BRAVOS existente com a aplicação do tablete tablet ou do site. Ele faz as interações com os sistemas e com o banco de dados, assegurando que as informações e operações realizadas no tablete tablet ou no site sejam consistentes.
Aplicação: A aplicação é a funcionalidade que é executada no tablete tablet ou no site, onde acontece a interação do usuário.
Todas as funcionalidades que rodam na aplicação se comunicam com o serviço, que por sua vez, faz a devida comunicação com o Linx DMS Apollo/BRAVOS.
Esta solução tem como objetivo o aprimoramento e inovação dos processos das concessionárias de veículos. É uma ferramenta robusta e pode ser utilizada pelos clientes da Linx que já possuem os pré-requisitos mínimos.
Pré-requisitos
O serviço do Linx DMS Services roda dentro do Internet Information Services (IIS), da Microsoft ou no APACHE.
A estação servidora precisa atender os seguintes requisitos, para execução do serviço:
- IIS 6.1 ou superior (Quando for utilizar o IIS)
- Microsoft .NET Framework 4.0 ou superior
- Importante: As orientações contidas neste manual referem-se ao sistema operacional no idioma português. Se o seu estiver em inglês, vão existir diferenças nas nomenclaturas. Se não encontrar um serviço mencionado em português, tente no idioma do seu sistema operacional.
Passos para Instalação
Para a instalação do Linx DMS Services você deve passar pelos seguintes passos:
*Clique no passo para ver mais detalhes.
Este passo só é necessário no caso de instalação do BRAVOS Mobile
Passo 1: Instalação do IIS
Para instalar o IIS, acesse o painel de controle do Windows.
Figura 1: Tela do Painel de Controle
Na guia "Programas e Recursos", selecione a seguinte opção:
"Ativar ou desativar recursos do Windows".
Selecione as opções conforme segue:
Obs.: Para nova instalação marcar TODAS as opções de SERVIÇOS DE INFORMAÇÃO DA INTERNET.
Figura 2: Tela de Instalação do IIS
Se o IIS já estiver instalado, é muito importante verificar se as opções abaixo estão marcadas.
Figura 3: Tela de Instalação do IIS
É obrigatório que estejam para que o serviço funcione.
Ao clicar em "OK", aguarde até que a instalação seja concluída.
Passo 2: Configuração do IIS
Para acessar as configurações do IIS, acesse o Painel de Controle do Windows.
Figura 4: Tela do Painel de Controle
Na guia "Sistema e Segurança", selecione a opção "Ferramentas Administrativas".
Acesse o programa "Gerenciador do Serviços de Informações da Internet (IIS)".
Figura 5: Tela do Painel de Controle
O primeiro passo é verificar se o ".NET Framework 4.0" (ou superior) está instalado adequadamente.
Para consultar, clique em "Pools de Aplicativos".
Figura 6: Tela de Configuração do IIS
No exemplo acima, é possível identificar que a versão 4.0 está instalada no servidor.
Caso a versão do Windows seja 64 bits, é necessário habilitar a execução de arquivos 32 bits.
Para habilitar, acesse, na guia de Ações, do Pool de Aplicativos, a opção <Definir Padrões do Pool de Aplicativos...>
Figura 7: Tela de Configuração do IIS
Na opção "Habilitar Aplicativos de 32 Bits", altere para "True", conforme indicado abaixo:
Figura 8: Tela de Configuração do IIS
Agora, vamos verificar se o website está associado ao pool correto.
Selecione o Default Web Site:
Figura 9: Tela de Configuração do IIS
Selecione a opção "Configurações Básicas":
Figura 10: Tela de Configuração do IIS
Clique em "Selecionar..."
Figura 11: Tela de Configuração do IIS
Selecione a opção "ASP.NET v4.0", conforme indicado abaixo:
Figura 12: Tela de Configuração do IIS
Agora vamos criar um novo aplicativo dentro do IIS.
Para criar, selecione, com o botão direito do mouse, o "Default Web Site", e clique em "Adicionar Diretório Virtual...".
Figura 13: Tela de Configuração do IIS
Preencha conforme exemplo abaixo:
Figura 14: Tela de Configuração do IIS
Clique em <Conectar como...> e informe um usuário Administrador.
Preencha a senha e confirme a senha.
Após, clique em <Testar Configurações> para verificar se a configuração é válida:
Figura 15: Tela de Configuração do IIS
Os módulos CGI e ISAPI precisam estar habilitados, para que a camada de conexão com o banco seja executada.
Para habilitar, acesse a opção "Mapeamentos de Manipulador" no IIS:
Figura 16: Tela de Configuração do IIS
Ao acessar os mapeamentos, é possível configurar quais estão aptos para execução.
Figura 17: Tela de Configuração do IIS
Se os módulos estiverem na guia "Desabilitada", é necessário habilitá-los.
Para habilitar, selecione o módulo CGI ou ISAPI, e clique em "Editar Permissões de Recurso..."
Figura 18: Tela de Configuração do IIS
Marque a opção "Executar", e cliquem em "Ok".
Figura 19: Tela de Configuração do IIS
Neste momento é preciso instalar o Linx DMS Services e, em seguida, será finalizada a configuração IIS.
Passo 3: Instalação do Linx DMS Services
Antes de tudo faça o download do pacote do Linx DMS Mobile ou BRAVOS Mobile no DVI da Linx, confome o seu sistema DMS. Nestes pacotes contêm todos os arquivos necessários para instalação/atualização e manuais. Ao acessar o DVI, após o login, siga o seguinte caminho:
Área de Arquivos Linx > Versão do Sistema – Versão APL > Linx DMS Mobile
Neste local você encontra a última versão do Linx DMS Mobile e BRAVOS Mobile. Basta fazer o download do arquivo compactado.
Observação: Para descompactar utilize o programa 7zip ou WinRar. O programa WInzip não funcionará para este caso.
Você terá acesso à seguinte estrutura de pastas:
Linx DMS:
Figura 20: Tela de Estrutura do Pacote
BRAVOS Mobile:
Figura 21: Tela de Estrutura do Pacote
Observação: Você necessitará deste pacote em diversos momentos durante a instalação. Mantenho-o numa pasta de fácil acesso.
Feito isso, para instalar o serviço Linx DMS Service, é preciso
...
executar o instalador
...
"LinxDMSServices.
...
exe", localizado na pasta LinxDMSServices contida no pacote baixado, no servidor de aplicação Windows. Durante a instalação do serviço IIS, ele sofrerá uma pausa que será reiniciado logo após.
Figura 122: LinxDMSServices.exe
Este instalador deve ser executado no servidor Windows onde está o IIS. Para realizar a instalação, basta seguir selecionando a opção <Next ou Avançar>, conforme idioma do Windows. Caso o usuário tenha feito a instalação padrão do IIS, o instalador indicará que a instalação deve ser realizada na pasta <C:\Inetpub\>. O serviço apontará automaticamente para a pasta inserida neste momento, veja as telas a seguir:
Figura 223: Linx DMS Services – Programa de Instalação
Figura 324: Linx DMS Services – Programa de Instalação
Após a instalação do serviço, será aberta automaticamente a tela referente às configurações do WebService:
Figura 25: Linx DMS Services – Programa de Instalação
Figura 426: Linx DMS Services – Programa de Instalação
Figura 527: Linx DMS Services – Programa de Instalação
Figura 6
Figura 28: Linx DMS Services – Programa de Instalação Instalação
Este mesmo programa poderá ser acessado novamente através do caminho <Iniciar > Programas > Linx DMS Services > Configurações do Serviço>. Neste programa é possível parametrizar os dados do Linx DMS Apollo/BRAVOS, a conexão com o banco de dados e outros parâmetros das funcionalidades da aplicação.
Passo 4: Configurações finais do IIS
IMPORTANTE
Os arquivos ".dll", referentes aos módulos contratados, precisam estar na lista de módulos permitidos do IIS.
Para efeito de manual criamos o termo "NOME_DA_DLL_DO_PACOTE.dll" onde o "NOME_DA_DLL_DO_PACOTE.dll" varia de acordo as regras abaixo:
Para Linx DMS Mobile / BRAVOS Mobile use LinxDmsMobile.dll
Para Pesquisa de Caixa VW use WSPesquisaCaixaVW.dll
Para o caso de possuir os dois módulos, as duas dlls devem estar permitidas no IIS.
Na tela inicial do IIS, clique duas vezes sobre a opção "Restrições de ISAPI e CGI".
Figura 29: Tela de Configuração do IIS
No canto superior direito da tela, clique na opção "Adicionar".
Figura 30: Tela de Configuração do IIS
Selecione o arquivo "NOME_DA_DLL_DO_PACOTE.dll", conforme a tela abaixo.
(Exemplo: C:\Inetpub\Services\WSFeedVW.dll)
Figura 31: Tela de Configuração do IIS
Ainda na tela de Restrições do ISAPI e CGI, clique em "Editar Configurações e Recurso...".
Figura 32: Tela de Configuração do IIS
Marque as duas opções conforme exemplo abaixo:
Figura 33: Tela de Configuração do IIS
Passo 5: Configuração do Banco de dados
A configuração do Banco de Dados deve ser:
Figura 734: Linx DMS Services – Programa de Instalação
...
- Tipo: Oracle ou SQL Server;
- Host: Não é necessário preencherCaso o banco de dados seja SQL Server, preencha com o IP do servidor;
- Database: Nome da base no Banco de Dados;
- Usuário: Usuário do banco (usuário padrão);
- Senha: Senha do usuário;
- DMS: Apollo:Linx DMS.
- Log Ativo: Marque esta opção para ativar o log das requisições. Ela pode ser utilizada caso encontre alguma dificuldade na operação. O serviço gera um log dentro do diretório C:\inetpub\services, com o nome de arquivo logAAAAMMDD.txt, onde <AAAAMMDD> é a data atual no formato ANO/MÊS/DIA. Envie o arquivo gerado em caso de atendimento no suporte.
- Armazenamento das imagens de veículos: As soluções mobile da Linx (Linx DMS Mobile e BRAVOS Mobile) permitem bater fotos com os dispositivos. Configure o diretório de destino das imagens gravadas.
Com essas configurações preenchidas, é possível testar a conexão clicando no botão 
.
A próxima parte das configurações diz respeito às funcionalidades das aplicações, onde deverá ser configurado conforme cada aplicação.
Depois que todos os campos foram preenchidos e configurados, basta clicar no botão <OK>.
Depois do programa de configurações fechado, será aberto o programa Gerenciador de Licenças Mobile. Por hora, feche este programa. A gestão de licenças será feita posteriormente somente para se for utilizado o módulo Linx DMS Mobile ou BRAVOS Mobile.
De volta ao instalador, finalize-o clicando no botão <Finalizar>.
Na tela abaixo, no campo <Versão do Windows>, será exibida a versão do Windows a qual está sendo instalado o serviço.
...
Para terminar, reinicie o Windows para que as novas configurações sejam carregadas corretamente.
Dúvidas
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte Linx DMS Apollo através do telefone +55 (51) 2101-9933, ou com o Suporte BRAVOS através do telefone +55 (51) 2101-9944, de acordo com o seu sistema DMS, ou através do site help.linx.com.br.
Para terminar, reinicie o Windows para que as novas configurações sejam carregadas corretamente.
Passo 6: Configurações específicas do BRAVOS Mobile
Se o produto a ser instalado é o BRAVOS Mobile, você deve seguir mais estas duas etapas:
1 - Configurações do IIS específicas para utilização do aplicativo "BRAVOS Mobile":
Acessar o item <Default Web Site>.
Figura 37: Tela de Configuração do IIS
Clicar, no lado direito da tela, na opção <Configurações Básicas>.
Figura 38: Tela de Configuração do IIS
Anotar o nome do campo "Pool de Aplicativos".
No caso acima, é o "DefaultAppPool".
Acessar a guia "Pool de Aplicativos":
Figura 39: Tela de Configuração do IIS
Localizar o pool identificado no passo anterior, e clicar em "Configurações Avançadas":
Figura 40: Tela de Configuração do IIS
Alterar a propriedade "Identidade" para "Local System", conforme indicado abaixo:
Figura 41: Tela de Configuração do IIS
2 - Configurações extras para utilização do PPSo através do BRAVOS Mobile
- O pré-requisito é que o PPSo já tenha sido configurado no BRAVOS, e a comunicação esteja funcionando;
- O arquivo "LinxPPSO.dll", contindo na pasta de instalação do BRAVOS no servidor, deve ser copiada para a pasta "C:\Windows\SysWOW64" ou "C:\Windows\System32" (de acordo com o sistema operacional) da máquina onde está sendo instalado o serviço, e ela sempre deverá ser atualizada com a última atualização disponível;
- Com a utilização da consulta PPSo através do BRAVOS Mobile, será gravado um log na pasta "C:\inetpub\services".
Passo 7: Testes do serviço
Para verificar se a camada de conexão com o banco de dados está em funcionamento, abra o navegador, e informe a seguinte url:
1 – Linx DMS Service:
http://localhost/services/LinxDMSMobile.dll
Exemplo:
Figura 35: Tela de Teste do Serviço
Se todas as configurações estiverem corretas, a mensagem acima será apresentada.
Uma vez que a camada de conexão com o banco estiver ativa, o Linx DMS Service estará pronto para uso.
2 – Pesquisa Caixa VW:
http://localhost/Services/WSPesquisaCaixaVW.dll
Se todas as configurações estiverem corretas, a mensagem abaixo será apresentada.
Figura 36: Tela de Estrutura do Pacote
Obs.: Verificar a Porta usada no IIS para fazer o teste de acesso ao caminho (se a Porta for diferente de 80, deve informar a respectiva porta no caminho. Por exemplo: http://localhost:8080/Services/WSPesquisaCaixaVW.dll ).
FAQ de erros do IIS
Figura 42: Tela de Erro de configuração do IIS
Caso a mensagem seja: Atributo não reconhecido "targetFramework", é porque o pool não está configurado para a versão 4.0.
Revise neste documento como ajustar a versão para a 4.0.
Figura 43: Tela de Erro de configuração do IIS
Caso a mensagem seja "Could not load file or assembly...", é porque o IIS não está configurado para aceitar módulos 32 bits.
Verifique nesta documentação como realizar esta configuração.
Figura 44: Tela de Erro de configuração do IIS
No exemplo acima, o arquivo ".dll", exemplo: LinxDmsMobile.dll, não está na lista de arquivos permitidos para execução.
Consulte este documento para permitir módulos CGI não especificados.
Caso o sistema tente realizar o download do arquivo ".dll", exemplo: LinxDmsMobile.dll, é porque os módulos CGI e ISAPI não estão ativos.
Figura 45: Tela de Erro de configuração do IIS
Consulte esta documentação para verificar como habilitá-los.
Caso já exista o APACHE rodando no servidor, ou outro serviço que esteja utilizando a porta 80, é possível alterar a porta do IIS.
Para alterar a porta, acesse, no console de gerenciamento do IIS, a opção "Associações":
Figura 46: Tela de configuração do IIS
Altere para a porta desejada:
Figura 47: Tela de configuração do IIS
Após o ajuste, reinicie o serviço para aplicar a mudança.
Figura 48: Tela de configuração do IIS
A causa deste problema é que o "ASP.NET" não está completamente instalado no servidor.
Para corrigir este problema, acesse o prompt de comando, em modo administrador, e execute o seguinte comando:
Em servidores 64 bits:
%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -i
Em servidores 32 bits:
%windir%\Microsoft.NET\Framework\v4.0.21006\aspnet_regiis.exe -i