Linx DMS Dashboard | Manual de InstalaçãoÍNDICE

IntroduçãoPré-requisitosInstalação do IISInstalação do DashboardConfiguração do IISTestando o ServiçoFAQ de erros do IIS

IntroduçãoPara 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é-requisitosO 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 IISPara 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 DashboardExecute 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 IISPara 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 , conforme exemplo abaixo:"C:\inetpub\dashboard\"

A variável contém o caminho, no IIS, para acesso ao arquivo "dashboardws.dll"."UrlServicos"Já a variável contém o caminho local, para acesso ao diretório de visões do "dashboard"."CaminhoXML"

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 , informando o IP de acesso à ela."UrlServicos"

Testando o ServiçoPara 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 , e a tela abaixo será apresentada:http://localhost/dashboard

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.