Linx DMS Dashboard
Manual de Instalação
Introdução
Para utilizar o Linx DMS Dashboard, é necessário preparar uma estação servidora, que irá hospedar o serviço responsável por seu funcionamento.
O Linx DMS Dashboard funciona na web, e é compatível com todos os navegadores do mercado. Seu funcionamento é compatível, inclusive, com tablets e smartphones.
O módulo é divido em duas camadas:
- Camada de apresentação;
- Camada de conexão com banco de dados.
Essa divisão permite que a estrutura seja agrupada em um único servidor (método padrão), ou dividida em dois servidores.
A divisão em dois servidores será especialmente útil caso o cliente desejar hospedar o serviço na nuvem, e manter a camada de comunicação com o banco de dados, em um servidor dentro da concessionária.
De qualquer forma, normalmente ambos os processos estarão no mesmo servidor.
Pré-requisitos
O serviço do Linx DMS Dashboard roda exclusivamente dentro do Internet Information Services (IIS), da Microsoft.
A estação servidora precisa atender os seguintes requisitos, para execução do serviço:
- IIS 6.1 ou superior;
- Microsoft .NET Framework 4.0 ou superior.
Caso precisar instalar o Framework 4.0, acesse o endereço abaixo para baixar o instalador:
https://www.microsoft.com/pt-br/download/details.aspx?id=42642.
Instalação do IIS
Para instalar o IIS, acesse o painel de controle do Windows.
Na guia "Programas e Recursos", selecione a seguinte opção:
- "Ativar ou desativar recursos do Windows".
Selecione as opções conforme segue:
Se o IIS já estiver instalado, é muito importante verificar se as opções abaixo estão marcadas.
É obrigatório que estejam para que o serviço funcione.
Ao clicar em "OK", aguarde até que a instalação seja concluída.
Instalação do Dashboard
Execute o programa "LinxDMSDashboard.exe".
Para continuar, clique em "Next".
Indique o diretório de instalação.
Por padrão, sugerimos que fique dentro do diretório padrão do IIS, conforme exemplo abaixo:
Para continuar, clique em "Next".
Avance as demais etapas até a conclusão do processo.
Ao concluir a instalação, será exibida a tela de configuração da conexão com o banco de dados:
Preencha os dados de conexão com o banco.
Ao concluir o preenchimento, clique em "Testar Conexão", para verificar se ela é estabelecida.
Para gravar as alterações, clique em "OK".
Configuração do IIS
Para acessar as configurações do IIS, acesse o Painel de Controle do Windows.
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)".
O primeiro passo é verificar se o ".NET Framework 4.0" (ou superior) está instalado adequadamente.
Para consultar, clique em "Pools de Aplicativos".
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...".
Na opção "Habilitar Aplicativos de 32 Bits", altere para "True", conforme indicado abaixo:
Agora, vamos verificar se o website está associado ao pool correto.
Selecione o website:
Selecione a opção "Configurações Básicas":
Clique em "Selecionar...":
Selecione a opção "ASP.NET v4.0", conforme indicado abaixo:
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 Aplicativo".
Preencha conforme exemplo abaixo:
Clique em "Testar Configurações", para verificar se a configuração é valida:
Caso o teste apresente o resultado acima, a configuração está apta para execução.
Se o teste apresentar erros, clique em "Conectar como....", e informe um usuário administrador para realizar a conexão.
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":
Ao acessar os mapeamentos, é possível configurar quais estão aptos para execução.
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...":
Marque a opção "Executar", e cliquem em "Ok".
O arquivo dashboardWS.dll precisa estar na lista de módulos permitidos do IIS.
Para incluir, acesse a lista de "Restrições ISAPI e CGI" do servidor, conforme indicado abaixo:
Clique em "Adicionar...", para incluir o arquivo:
Preencha conforme exemplo abaixo:
Não esqueça de marcar a opção "Permitir que o caminho da extensão seja executado".
A última configuração necessária, para utilizar o módulo, está no arquivo "web.config", que foi criada durante a instalação do sistema.
O diretório padrão de localização do arquivo é em "C:\inetpub\dashboard\", conforme exemplo abaixo:
A variável "UrlServicos" contém o caminho, no IIS, para acesso ao arquivo "dashboardws.dll".
Já a variável "CaminhoXML" contém o caminho local, para acesso ao diretório de visões do "dashboard".
Se a instalação seguiu o padrão de diretórios sugeridos, não será necessário alterar estas configurações.
Se a camada de acesso ao banco de dados estiver em um segundo servidor, será necessário alterar a variável "UrlServicos", informando o IP de acesso à ela.
Testando o 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:
http://localhost/dashboard/dashboardws.dll.
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 Dashboard estará pronto para uso.
Acesse a url http://localhost/dashboard, e a tela abaixo será apresentada:
FAQ de erros 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.
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.
No exemplo acima, o arquivo "dashboardws.dll" não está na lista de arquivos permitidos para execução.
Consulte este documento para verificar como incluir o arquivo na lista de módulos permitidos.
Caso o sistema tente realizar o download do arquivo "dashboardws.dll", é porque os módulos CGI e ISAPI não estão ativos.
Consulte esta página 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":
Altere para a porta desejada:
Após o ajuste, reinicie o serviço para aplicar a mudança.
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.
Dúvidas
Em caso de dúvidas sobre o conteúdo deste documento, entre em contato com o Suporte através do telefone +55 (51) 2101-9933 para o Linx DMS Apollo, +55 (51) 2101-9944 para o BRAVOS, ou através do site help.linx.com.br.