Mudanças entre as edições de "Instalando o LATROMI Web"
(→Testando o Site) |
|||
| (59 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 | + | * 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 === | ||
| − | + | # 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''. | |
| − | + | # 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++. | |
| − | + | # 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 === | === Criando o site no 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 .NET v4.0'', utilizando a versão 4.0 do .NET Framework. | |
| − | [[Arquivo: | + | #: [[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]] | |
| − | [[Arquivo: | + | # 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: | + | #: [[Arquivo:Win10_iis10_criando_aplicativo.jpg|Configuração da Conversão do Aplicativo]] |
| − | |||
| − | [[Arquivo: | ||
| − | |||
=== Testando o Site === | === 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''. | 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/ | + | Ou se preferir, acesse diretamente pelo navegador o endereço http://localhost:8081/web |
<br /> | <br /> | ||
| − | Se a página de login do sistema for exibida, então a instalação foi bem sucedida. | + | Se a página de login do sistema for exibida, então a instalação foi bem sucedida. |
| + | |||
| + | [[Arquivo:site_login.jpg|Página de Login do Sistema]] | ||
=== Validando a Licença de Uso === | === Validando a Licença de Uso === | ||
| − | A chave da licença de uso deve ser informada através do | + | 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 /> |
| − | 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. | + | 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 54: | 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] | + | * [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 | + | 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 | + | * 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. | + | * 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] | ||
| + | |||
| − | + | [[Category:Instalação]] | |
| − | [ | ||
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
- Entre na nossa pasta compartilhada da DropBox.
- Em seguida, abra a subpasta LATROMI. Serão listadas diversas pastas. Cada uma delas corresponde a uma versão do sistema.
- 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.
- Aba a pasta Web e baixe a versão mais recente.
Extração dos arquivos
- 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.
- 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
- 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 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
- 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 .NET v4.0, utilizando a versão 4.0 do .NET Framework.
- 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.
- 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
- Selecione o Pool de Aplicativos LATROMI .NET v4.0 que foi criado nos passos acima, e clique em OK.
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.
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
- Se o .NET Framework 4.5 foi instalado antes do IIS, tente registrar o ASP.NET utilizando a ferramenta Aspnet_regiis.exe da Microsoft.
Registrar o ASP.NET: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir
Runtime error
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).
