Mudanças entre as edições de "Instalando o LATROMI Web"

De LATROMI Manuais
Ir para: navegação, pesquisa
(→‎Extração dos arquivos)
 
(66 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 1: Linha 1:
 
== Requisitos mínimos ==
 
== Requisitos mínimos ==
−
* .NET Framework 4.5
+
* .NET Framework 4.5.2
−
* Internet Information Service 7 ou superior (IIS 7)
+
* Internet Information Service (IIS) 7 ou superior
 
* ASP.NET 4.0
 
* ASP.NET 4.0
 +
* Banco de dados do sistema LATROMI
  
 
== Instalação ==
 
== Instalação ==
 +
 +
Atualmente, o LATROMI Web não possui um instalador. Portanto, é necessário baixar e fazer a hospedagem do site manualmente no IIS do servidor. O processo é simples para quem já está familiarizado com o Gerenciador de IIS do Windows.
 +
 +
O processo consiste em baixar um arquivo compactado, extrai-lo em um diretório, ajustar os dados de conexão no arquivo de configuração e por fim configurar o aplicativo no IIS. Estes passos serão abordados detalhadamente abaixo.
 +
 +
=== Download dos Arquivos ===
 +
{{Tutorial/Download|app = Web}}
 +
 
=== Extração dos arquivos ===
 
=== Extração dos arquivos ===
−
* Baixe o pacote que contém os arquivos de instalação, que seguem no formato ''wecdb_<versao>-bin.zip''
+
# Crie uma pasta ''wwwlatromi'' no diretório do IIS (por padrão, c:\inetpub) e extraia o arquivo baixado lá, em uma sub-pasta chamada ''web''.
−
* Crie uma pasta ''LATROMI\WecDB'' no diretório do IIS (por padrão, c:\inetpub\wwwroot) e extraia os arquivos lá.
+
# Certifique-se de que o usuário usado pelo IIS para acessar o caminho físico dos arquivos tenha permissão total sobre a pasta e sub-pastas da aplicação.
  
 
=== Alterando o arquivo Web.config ===
 
=== Alterando o arquivo Web.config ===
−
* Dentre os arquivos que foram extraídos, está um arquivo chamado '''Web.config'''. Abra ele com algum editor de texto como Notepad ou Notepad++.
+
# Dentre os arquivos que foram extraídos, está um arquivo chamado '''Web.config'''. Abra ele com algum editor de texto como Notepad ou Notepad++.
−
* Procure dentro do arquivo a sessão ''connectionStrings'', e substitua os parâmetros abaixo com os dados do seu banco de dados:
+
# Procure dentro do arquivo a sessão ''connectionStrings'', e substitua os parâmetros abaixo com os dados do banco de dados do sistema LATROMI:
−
** '''Server''': Servidor onde o banco de dados está instalado.
+
#: '''Server''': Servidor onde o banco de dados está instalado.
−
** '''Port''': Porta do servidor de banco de dados.
+
#: '''Port''': Porta do servidor de banco de dados.
−
** '''Database''': Nome do banco de dados utilizado (por padrão, o banco é latromi).
+
#: '''Database''': Nome do banco de dados utilizado (por padrão, o banco é latromi).
−
** '''User Id''': Usuário para conectar ao banco de dados.
+
#: '''User Id''': Usuário para conectar ao banco de dados.
−
** '''Password''': Senha do usuário para acessar o banco de dados.
+
#: '''Password''': Senha do usuário para acessar o banco de dados.
−
* Agora, ainda dentro do arquivo Web.config, localize o parâmetro ''License'' dentro da sessão ''appSettings'', e informe no atributo ''value'' a sua chave de licensa.
 
  
 
=== Criando o site no IIS ===
 
=== Criando o site no IIS ===
−
* Vá em Iniciar > Executar e digite ''inetmgr'' para abrir o gerenciador de IIS.
+
# Vá em Iniciar > Executar e digite ''inetmgr'' para abrir o gerenciador de IIS.
−
* Vá em '''Pools de Aplicativo''', e crie um novo pool, chamado LATROMI, utilizando a versão 4.0 do .NET Framework.
+
# Vá em '''Pools de Aplicativo''', e crie um novo pool, chamado ''LATROMI .NET v4.0'', utilizando a versão 4.0 do .NET Framework.
−
[[Arquivo:Win7_iis7_criando_pool.png|Configurações Avançadas do Pool de Aplicativos]]
+
#: [[Arquivo:Win10_iis10_criando_pool.jpg|Configurações Avançadas do Pool de Aplicativos]]
 +
# Agora que o Pool de Aplicativos está devidamente configurado, vamos criar o Site no IIS. Para começar, clique com o botão direito do sobre sobre o item ''Sites'' e em seguida em ''Adicionar Site...''.
 +
# Preencha os campos para criação do site, tomando como exemplo a imagem abaixo.
 +
#: [[Arquivo:Win10_iis10_criando_site.jpg]]
 +
# Localize no IIS a pasta ''Web'' onde os arquivos foram extraídos, clique com o botão direito do mouse sobre ela, e vá até a opção ''Converter para Aplicativo''
 +
#: [[Arquivo:Win10_iis10_convertendo_aplicativo.jpg|Convertendo diretório em Aplicativo]]
 +
# Selecione o Pool de Aplicativos ''LATROMI .NET v4.0'' que foi criado nos passos acima, e clique em OK.
 +
#: [[Arquivo:Win10_iis10_criando_aplicativo.jpg|Configuração da Conversão do Aplicativo]]
  
−
* Clique com o botão direito do mouse sobre o novo Pool de Aplicativos, e vá até a opção ''Configurações Avançadas''.
+
=== Testando o Site ===
−
* Na tela de Configurações Avançadas, informe '''true''' na opção '''Habilitar Aplicativo de 32 Bits'''. (essa opção é importante para que funcione a integração com o Crystal Reports)
+
Para testar o site, ainda dentro do gerenciador de IIS, clique sobre a pasta convertida para aplicativo, em seguida clique com o botão direito do mouse, e vá até a opção ''Procurar''.  
−
[[Arquivo:Win7_iis7_configurando_pool.png|Criação do Pool de Aplicativos]]
+
Ou se preferir, acesse diretamente pelo navegador o endereço http://localhost:8081/web
 +
<br />
 +
Se a página de login do sistema for exibida, então a instalação foi bem sucedida.
  
−
* Agora que o Pool de Aplicativos está devidamente configurado, localize a pasta WecDB onde o site foi extraído, dentro do grupo de sites no gerenciador de IIS, clique com o botão direito do mouse sobre ela, e vá até a opção '''Converter para Aplicativo'''.
+
[[Arquivo:site_login.jpg|Página de Login do Sistema]]
−
[[Arquivo:Win7_iis7_converter_para_aplicativo.png|Convertendo diretório em Aplicativo]]
+
 
−
* Informe o Pool de Aplicativos LATROMI que foi criado nos passos acima, e clique em OK.
+
=== Validando a Licença de Uso ===
−
[[Arquivo:Win7_iis7_converter_para_aplicativo_confirmacao.png|Configuração da Conversão do Aplicativo]]
+
A chave da licença de uso deve ser informada através do ''LATROMI Client''. Ela é ativada ao realizar o primeiro login no sistema. <br />
−
* Agora para testar o site, clique sobre a pasta convertida para aplicativo, e em seguida clique com o botão direito do mouse, e vá até a opção ''Procurar''.
+
Acesse o site utilizando o usuário ''Admin'' criado na instalação (senha "admin"). Se a página inicial do LATROMI for exibida, a licença foi validada com êxito.
  
 
== Erros de inicialização ==
 
== Erros de inicialização ==
Linha 45: Linha 62:
  
 
'''Ações que podem resolver o problema''' <br />
 
'''Ações que podem resolver o problema''' <br />
−
* [https://technet.microsoft.com/pt-br/library/hh831475.aspx#InstallIIS Instale o ASP.NET] por meio da instalação do IIS.
+
* [https://technet.microsoft.com/pt-br/library/hh831475.aspx#InstallIIS Instale o ASP.NET], caso não estaja instalado
 
* Verifique se a [[Verificar se a extensão do ASP.NET está habilitada|extensão ASP.NET está habilitada]] no servidor.
 
* Verifique se a [[Verificar se a extensão do ASP.NET está habilitada|extensão ASP.NET está habilitada]] no servidor.
 
* Verifique se o local da extensão está correto.
 
* Verifique se o local da extensão está correto.
 
* Verifique se a URL da extensão foi digitada corretamente, tanto no navegador quanto no servidor Web.
 
* Verifique se a URL da extensão foi digitada corretamente, tanto no navegador quanto no servidor Web.
 +
  
 
=== Erro HTTP 500.21 - Internal Server Error ===
 
=== Erro HTTP 500.21 - Internal Server Error ===
−
A página que você está solicitando não pode ser servida devido a um erro na execução do .NET Framework 4.0.  
+
A página que você está solicitando não pode ser servida devido a um erro na execução do .NET Framework.  
  
 
'''Causas mais prováveis''' <br />
 
'''Causas mais prováveis''' <br />
−
* O IIS foi instalado depois do .NET Framework 4.5. Neste caso o Framework 4.0 não foi registrado para uso no IIS.
+
* O IIS foi instalado depois do .NET Framework 4.5. Neste caso o Framework não foi registrado para uso no IIS.
 
* O .NET Framework não está instalado ou não foi instalado corretamente.
 
* O .NET Framework não está instalado ou não foi instalado corretamente.
  
 
'''Ações que podem resolver o problema''' <br />
 
'''Ações que podem resolver o problema''' <br />
−
* Se o .NET Framework 4.0 foi instalado antes do IIS, tente [[Registrando uma versão do ASP.NET no IIS |registrar o ASP.NET]] utilizando a ferramenta [http://msdn.microsoft.com/en-us/library/k6h9cz8h.aspx Aspnet_regiis.exe] da Microsoft.
+
* Se o .NET Framework 4.5 foi instalado antes do IIS, tente [[Registrando uma versão do ASP.NET no IIS |registrar o ASP.NET]] utilizando a ferramenta [http://msdn.microsoft.com/en-us/library/k6h9cz8h.aspx Aspnet_regiis.exe] da Microsoft.
 +
 
 +
: <pre>Registrar o ASP.NET: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir</pre>
 +
 
 +
=== Runtime error ===
 +
[[Arquivo:IIS7_RuntimeError.jpg]]
 +
 
 +
'''Causas mais prováveis''' <br />
 +
* Falta de permissões para usuário do IIS.
 +
 
 +
'''Ações que podem resolver o problema''' <br />
 +
* Altere as permissões de diretório, concedendo todas as permissões para o usuário que estiver rodando o serviço do IIS ou para o usuário '''Todos''' (Everyone).
 +
 
 +
== Ver Também ==
 +
* [[Instalando o LATROMI Client|Manual de Instalação do LATROMI Client]]
 +
* [[Padrão de Versionamento de Software]]
 +
* [https://msdn.microsoft.com/pt-br/library/Hh925568(v=VS.110).aspx Como determinar quais versões do .NET Framework estão instaladas]
 +
 
  
−
=== Ver Também ===
+
[[Category:Instalação]]
−
[https://msdn.microsoft.com/pt-br/library/Hh925568(v=VS.110).aspx Como determinar quais versões do .NET Framework estão instaladas]
 

Edição atual tal como às 16h09min de 1 de junho de 2017

Requisitos mínimos

  • .NET Framework 4.5.2
  • Internet Information Service (IIS) 7 ou superior
  • ASP.NET 4.0
  • Banco de dados do sistema LATROMI

Instalação

Atualmente, o LATROMI Web não possui um instalador. Portanto, é necessário baixar e fazer a hospedagem do site manualmente no IIS do servidor. O processo é simples para quem já está familiarizado com o Gerenciador de IIS do Windows.

O processo consiste em baixar um arquivo compactado, extrai-lo em um diretório, ajustar os dados de conexão no arquivo de configuração e por fim configurar o aplicativo no IIS. Estes passos serão abordados detalhadamente abaixo.

Download dos Arquivos

  1. Entre na nossa pasta compartilhada da DropBox.
  2. Em seguida, abra a subpasta LATROMI. Serão listadas diversas pastas. Cada uma delas corresponde a uma versão do sistema.
  3. Abra a subpasta correspondente a versão mais recente do sistema. Dentro dela, existem duas subpastas:
    • Subpasta Web: Onde estão os arquivos necessários para instalação do site no IIS.
    • Subpasta Client: Onde estão os arquivos necessários para instalação do Client. Note que o nome de alguns arquivos terminam com "-bin". Estes, assim como os arquivos compactados da pasta Web, possuem todos os arquivos necessários para o funcionamento do aplicativo. Basta extrair em um diretório e utilizar. Os arquivos cujo o nome não terminam com "-bin" são instaladores. Ao utilizá-los, o programa será instalado no Windows, e um ícone para desinstalação será criado no Painel de Controle > Adicionar ou Remover Programas.
  4. Aba a pasta Web e baixe a versão mais recente.

Extração dos arquivos

  1. Crie uma pasta wwwlatromi no diretório do IIS (por padrão, c:\inetpub) e extraia o arquivo baixado lá, em uma sub-pasta chamada web.
  2. Certifique-se de que o usuário usado pelo IIS para acessar o caminho físico dos arquivos tenha permissão total sobre a pasta e sub-pastas da aplicação.

Alterando o arquivo Web.config

  1. Dentre os arquivos que foram extraídos, está um arquivo chamado Web.config. Abra ele com algum editor de texto como Notepad ou Notepad++.
  2. Procure dentro do arquivo a sessão connectionStrings, e substitua os parâmetros abaixo com os dados do banco de dados do sistema LATROMI:
    Server: Servidor onde o banco de dados está instalado.
    Port: Porta do servidor de banco de dados.
    Database: Nome do banco de dados utilizado (por padrão, o banco é latromi).
    User Id: Usuário para conectar ao banco de dados.
    Password: Senha do usuário para acessar o banco de dados.

Criando o site no IIS

  1. Vá em Iniciar > Executar e digite inetmgr para abrir o gerenciador de IIS.
  2. Vá em Pools de Aplicativo, e crie um novo pool, chamado LATROMI .NET v4.0, utilizando a versão 4.0 do .NET Framework.
    Configurações Avançadas do Pool de Aplicativos
  3. Agora que o Pool de Aplicativos está devidamente configurado, vamos criar o Site no IIS. Para começar, clique com o botão direito do sobre sobre o item Sites e em seguida em Adicionar Site....
  4. Preencha os campos para criação do site, tomando como exemplo a imagem abaixo.
    Win10 iis10 criando site.jpg
  5. Localize no IIS a pasta Web onde os arquivos foram extraídos, clique com o botão direito do mouse sobre ela, e vá até a opção Converter para Aplicativo
    Convertendo diretório em Aplicativo
  6. Selecione o Pool de Aplicativos LATROMI .NET v4.0 que foi criado nos passos acima, e clique em OK.
    Configuração da Conversão do Aplicativo

Testando o Site

Para testar o site, ainda dentro do gerenciador de IIS, clique sobre a pasta convertida para aplicativo, em seguida clique com o botão direito do mouse, e vá até a opção Procurar. Ou se preferir, acesse diretamente pelo navegador o endereço http://localhost:8081/web
Se a página de login do sistema for exibida, então a instalação foi bem sucedida.

Página de Login do Sistema

Validando a Licença de Uso

A chave da licença de uso deve ser informada através do LATROMI Client. Ela é ativada ao realizar o primeiro login no sistema.
Acesse o site utilizando o usuário Admin criado na instalação (senha "admin"). Se a página inicial do LATROMI for exibida, a licença foi validada com êxito.

Erros de inicialização

Erro HTTP 404.2 - Not Found

A página que você está solicitando não pode ser servida devido às configurações da lista de Restrições ISAPI e CGI no servidor Web.

Causas mais prováveis:

  • Não foi encontrado nenhum mapeamento de manipulador para essa solicitação. Talvez seja necessário instalar um recurso.
  • A extensão de serviço da Web do recurso solicitado não está habilitada no servidor.
  • O mapeamento da extensão aponta para o local incorreto.
  • A extensão foi digitada incorretamente no navegador ou no servidor Web.

Ações que podem resolver o problema

  • Instale o ASP.NET, caso não estaja instalado
  • Verifique se a extensão ASP.NET está habilitada no servidor.
  • Verifique se o local da extensão está correto.
  • Verifique se a URL da extensão foi digitada corretamente, tanto no navegador quanto no servidor Web.


Erro HTTP 500.21 - Internal Server Error

A página que você está solicitando não pode ser servida devido a um erro na execução do .NET Framework.

Causas mais prováveis

  • O IIS foi instalado depois do .NET Framework 4.5. Neste caso o Framework não foi registrado para uso no IIS.
  • O .NET Framework não está instalado ou não foi instalado corretamente.

Ações que podem resolver o problema 

Registrar o ASP.NET: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

Runtime error

IIS7 RuntimeError.jpg

Causas mais prováveis

  • Falta de permissões para usuário do IIS.

Ações que podem resolver o problema

  • Altere as permissões de diretório, concedendo todas as permissões para o usuário que estiver rodando o serviço do IIS ou para o usuário Todos (Everyone).

Ver Também

Disponível em "http://docs.latromi.com.br/index.php?title=Instalando_o_LATROMI_Web&oldid=1274"