Páginas filhas
  • Portal de Imóveis - Instalação e configuração

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
idPortal
Card
labelInstalação

Objetivo

Esta página tem como objetivo de aproximar o usuário ao conhecimento do processo instalação e configuração do Portal de Imóveis.

Procedimentos para Instalação do Portal de Imóveis

Para clientes novos o Portal de Imóveis deverá ser instalado através do instalador RM Portais (extensão MSI).

No video abaixo, demonstra a instalação dos itens:

  • PHP Manager

  • Instalação do Portal de Imóveis

Multimedia
nameInstalando portal de imóveis.mp4
autostarttrue

Painel
titleColor#FF9000
titleNotas
  1. Finalizando o processo de instalação, se você manteve a pasta padrão de instalação o caminho onde os arquivos do Portal de Imóveis foram instalados será: C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI

  2. A conexão com o Portal de Imóveis está homologada para ser configurada utilizando apenas o protocolo http:
Card
labelConfigurando IIS

Objetivo

Esta página tem como objetivo descrever o processo de configuração do Portal de Imóveis utilizando IIS

Para configurar, siga os passos abaixo:


Deck of Cards
idEtapas do Wizard
Card
labelPasso 1


Pré-requisitos e instalações do IIS

itens

URLRewrite

O URLrewrite é uma extensão para o IIS, que provê poderosos controles sobre as URL´s e facilitando a administração e busca de sites.
Acesse o endereço http://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads e baixe a versão correspondente ao seu sistema operacional.

PHP Manager

PHP Manager é o software gerenciador do PHP para o IIS.
Acesse 
https://github.com/phpmanager/phpmanager/releases vá para a opção Downloads e escolha o arquivo que correto para a versão do seu sistema operacional (32 ou 64 bits)

Microsoft® ODBC Driver 17 for SQL Server

Driver SQL 17 para conexão com banco de dados. Faça o download no link da Microsoft
Acesse https://www.microsoft.com/en-us/download/details.aspx?id=56567 Selecione o idioma do seu SQL Server. E marque o arquivo para download.

Microsoft Visual C++ Redistributable

Microsoft Visual C++ Redistributable, baixe a versão mais recente do microsoft visual c++ 
Acesse https://support.microsoft.com/pt-br/topic/os-downloads-do-visual-c-mais-recentes-com-suporte-2647da03-1eea-4433-9aff-95f26a218cc0 
Baixe a versão de acordo com o seu sistema operacional.

image2022-1-26_8-32-14.png



Card
labelPasso 2


Configurando o Portal de Imóveis no IIS

Ao finalizar a instalação da Biblioteca do RM Portal, será criado um site no IIS com o nome PVI. O site é criado e toda a comunicação do IIS acontece na pasta C:\TOTVS\CorporeRM\FrameHTML\web\app\Imb\PVI  caminho que foi definido durante o processo de instalação do Portal de Imóveis

Card
labelPasso 3


Alterando o Application Pool

Acesse o IIS (Internet Information Service - pode digitar INETMGR na pesquisa de programas do windows)

Expanda "Application Pools", selecione "Corpore.Net", clique "Advanced Settings" e altere "Load User Profile (carregar perfil do usuário)" para "True (verdadeiro)". Clique Ok para salvar.
Nota: Apesar de estar mostrando .Net 4.0 na configuração, é indiferente usar .Net 2.0 ou 4.0.

Ainda em Aplication Pools, devemos colocar o usuário administrador da máquina ou administrador do domínio no campo Modelo de Processo -> Identidade. Será exigido nome do usuário e senha.

Card
labelPasso 4


Permissão da pasta ao IIS

O IIS realiza interações com a pasta do site e ele deve ter permissão total de acesso a pasta. É necessário inserir nas propriedades da pasta o controle total para o IIS: NOMEDAMAQUINA\IIS_IUSRS.
Acesse a pasta da instalação do portal, C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI 

Card
labelPasso 5


Testando a comunicação do IIS

Uma das formas de se testar a comunicação do IIS é abrir o site clicando em Procurar Site:

Card
labelConfigurando Portal de Imóveis

Objetivo

Esta página tem como objetivo de configurar o Portal de Imóveis.

A partir da versão 12.1.33, o wizard de instalação do Portal de Imóveis foi modificado, simplificando a instalação do portal e a configuração dos bancos de dados e webservices RM.


Deck of Cards
idEtapas do Wizard
Card
labelPasso 1


Sobre o instalador

Esta etapa é apenas uma introdução que resume os procedimentos que deverão ser executados

Card
labelPasso 2


Conexão com WebService TOTVS

Neste momento deveremos definir o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.

Card
labelPasso 3


Caminho do banco de dados


Nesta etapa iremos configurar os dados do banco onde o Portal de Vendas de Imóveis será instalado

  • DBMS: MySql ou SQLServer;
  • Servidor: Selecionar o IP ou IP/Instância;
  • Porta: Usar a padrão do DBMS ou a definida no DBMS;
  • Nome do Banco de Dados: Por padrão o nome do banco de dados default é o Portal de Imóveis podendo ser alterado;
  • Usuário do Banco do Portal de Imóveis: Usuário de acesso do banco de dados;
  • Senha do Banco do Portal de Imóveis: Senha de acesso do usuário.

Card
labelPasso 4


Instalação concluída

Nesta etapa será apenas um informativo com as configurações de login para o primeiro acesso no Portal de Imóveis.



Card
labelConfigurando Comissão 2.0

Objetivo

Esta página tem como objetivo de orientar a configuração da Comissão 2.0 dentro do portal de imóveis.

A comissão 2.0 está sendo construída utilizando o PO UI Biblioteca de componentes baseado em Angular e é hospedado de forma nativa no RM.Host, neste documento vamos abordar os procedimentos necessários para a configuração.


Informações
titleInformação!

A comissão 2.0 está disponível para versão TOTVS RM Portal - 12.1.2205 apenas para cliente piloto.



Deck of Cards
idConfiguracoes
Card
defaulttrue
labelConfiguração do Host


Para o correto funcionamento da comissão 2.0 dentro do Portal de imóveis, é necessário que o
Host seja iniciado com privilégios de administrador e que o RM.Host.config ou RM.Host.Service.Config esteja devidamente configurado, pois o mesmo terá informações necessárias para o consumo de serviços do Portal.

Execução do Host como Administrador:

Caso o Host seja iniciado como aplicativo (RM.Host.exe), certifique-se que ao executá-lo, tenha selecionado a opção "Executar como Administrador".
Caso o Host tenha sido instalado como serviço, o usuário vinculado ao serviço deve ser um administrador do sistema. Esta configuração pode ser feita por meio dos serviços do Windows, informando um usuário específico ou utilizar a conta local do sistema, conforme imagem abaixo:



Arquivos de configuração do Host.

  1.  Para incluir/editar as portas pelo arquivo de configuração, acesse o diretório C:\totvs\CorporeRM\RM.Net, e edite os arquivos RM.Host.exe.config ou RM.Host.Service.exe.config.



  2. Inclua/edite as tags abaixo, em ambos os arquivos, dentro do escopo das tags appSettings:

    <add key="ApiPort" value="8052" /> Porta onde será realizada a comunicação da API
    <add key="HttpPort" value="8051" />
    <add key="DefaultDb" value="CorporeRM"/>   Nome do alias que será utilizado por default ao acessar o Portal RM

    Obs.: Neste exemplo utilizamos a porta 8052, caso esta seja utilizada para outra finalidade o departamento de TI deverá informar outra porta para uso.

    Exemplo:

    RM.Host.exe.configRM.Host.Service.exe.config
    Bloco de código
    languagexml
    themeEclipse
    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
     <appSettings>
      <add key="JobServer3Camadas" value="false" />
      <add key="DefaultDB" value="CorporeRM" /> 
      <add key="Port" value="8050" />
      <add key="HTTPPort" value="8051" />
      <add key="ApiPort" value="8052" /> 
      <add key="Host" value="BHN050103554" />
      <add key="ActionsPath" 
           value="C:\RM\Legado\12.1.2205\Bin;
           C:\RM\Legado\12.1.2205\Corpore.Net\Bin" />
      <add key="LibPath" value="C:\RM\Legado\12.1.2205\Bin" />
      <add key="EnableDynamicLocalization" value="false" />
      <add key="EnableCompression" value="false" />
      <add key="LocalizationLanguage" value="pt-BR" />
     </appSettings>
     <runtime>
       <generatePublisherEvidence enabled="false" />
       <loadFromRemoteSources enabled="false" />
     </runtime>
    </configuration>
    Bloco de código
    languagexml
    themeEclipse
    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
     <appSettings>
      <add key="JobServer3Camadas" value="false" />
      <add key="DefaultDB" value="CorporeRM" />
      <add key="Port" value="8050" />
      <add key="HTTPPort" value="8051" />
      <add key="ApiPort" value="8052" />
      
      <add key="ActionsPath" 
           value="C:\totvs\CorporeRM\RM.Net;
           C:\totvs\CorporeRM\Corpore.Net\Bin" />
      <add key="LibPath" value="C:\totvs\CorporeRM\RM.Net" />
      <add key="EnableDynamicLocalization" value="false" />
      <add key="LocalizationLanguage" value="pt-BR" />
     </appSettings>
     <runtime>     
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" />
      <gcServer enabled="true" />
      <generatePublisherEvidence enabled="false" />  </runtime>
    </configuration>
    
    

    Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do Host.


Card
labelConfiguração do Portal


Para configurar o Portal para comissão 2.0 será necessário configurar os itens:

  • config.json

  • API REST TOTVS: URL 

  • web.config


Deck of Cards
idEtapas do Wizard
Card
labelPasso 1


Configurando config.json do Portal que acessa o Serviço de API do Host

No diretório de instalação da biblioteca RM "C:\TOTVS\CorporeRM\RM.Net\wwwroot\config\" abra o arquivo de configuração do Portal "config.json". Nele serão possíveis de se efetuar as seguintes configurações:

Bloco de código
firstline1
titleconfig.json
linenumberstrue
{
	"apiServer": "http://BHN050103554:8052/",
}


"apiServer": endereço da API do serviço do Host do RM

  • A porta da API deve estar preenchida com a mesma porta informada na configuração do Host:  "ApiPort".
  • O endereço localhost limita o acesso no portal somente para ambiente de desenvolvimento. Para acessos externos o endereço deve ser alterado para o nome completo do computador (Exemplo: http://BHN050103554.bh01.local:8052) onde BHN050103554 é o nome da máquina, ou o IP, como exemplo da imagem anterior.


Informações
titleImportante

Após configurar o arquivo config.json, é necessário limpar o cache do navegador, caso contrário, o arquivo de configuração antigo será mantido por um tempo.
A Tag rmApiServer deve obrigatoriamente terminar com barra "/".

Card
labelPasso 2


Configurando parametro: API REST TOTVS: URL no Portal


Acesse o Portal de Imóveis - Backend - Parâmetros - TOTVS


API REST TOTVS: URL

URL base para acessar as APIS da TOTVS

Informações
titleImportante

 A porta será informada na TAG: ApiPort do arquivo de configuração do Host: 
Exemplo: <add key="ApiPort" value="8052" />

Card
labelPasso 3


Configurando web.config do Portal de Imóveis


Certifique a existência do arquivo web.config  em seu ambiente de instalação do portal. 
Geralmente, é adotado o caminho fisico,  (C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI\API\ 
Segue o padrão do Web.config

Bloco de código
languagexml
themeEclipse
titleWeb.config
<configuration>
<system.webServer>
    <rewrite>
        <rules>
          <rule name="ignore-ui" stopProcessing="true">
            <match url="^ui" />
            <action type="None" />
          </rule>
          <rule name="ignore-ui-json" stopProcessing="true">
            <match url="^pvi-openapi.json" />
            <action type="None" />
          </rule>
          <rule name="slim catch all" enabled="true">
              <match url=".*" />
              <action type="Rewrite" url="index.php" />
              <conditions>
                  <add input="{URL}" pattern="sync*" negate="true" />
              </conditions>
          </rule>
        </rules>
    </rewrite>
    <httpProtocol>
    <customHeaders>
      <add name="Access-Control-Allow-Origin" value="*" />
      <add name="Access-Control-Allow-Headers" value="*" />
    </customHeaders>
  </httpProtocol>
</system.webServer>
</configuration>

Painel
titleColor#FF9000
titleNotas
  • Vale lembrar que, por padrão o compartilhamento de recursos com origens diferentes (CORS)  vai liberado.
    Caso seja necessário bloquear algumas destas configurações, o Web.config do portal de imóveis na pasta /PVI/api, deverá ser alterado. as tag's responsáveis são:

    Bloco de código
    languagexml
    themeEclipse
    titleCors
    <httpProtocol>
        <customHeaders>
          <add name="Access-Control-Allow-Origin" value="*" />
          <add name="Access-Control-Allow-Headers" value="*" />
        </customHeaders>
      </httpProtocol>
Card
labellinks úteis

Objetivo

Esta página tem como objetivo disponibilizar os links dos pacotes adicionais necessários para instalação Portal de Imóveis.


URLRewrite

O URLrewrite é uma extensão para o IIS, que disponibiliza controles sobre as URL´s e facilitando a administração e busca de sites.
Acesse o endereço http://www.iis.net/downloads/microsoft/url-rewrite#additionalDownloads e baixe a versão correspondente ao seu sistema operacional.


PHP Manager

PHP Manager é o software gerenciador do PHP para o IIS.
Acesse 
https://github.com/phpmanager/phpmanager/releases vá para a opção Downloads e selecione o arquivo correto para a versão do seu sistema operacional (32 ou 64 bits)


Microsoft® ODBC Driver 17 for SQL Server

Driver SQL 17 para conexão com banco de dados. Faça o download no link da Microsoft
Acesse https://www.microsoft.com/en-us/download/details.aspx?id=56567 Selecione o idioma do seu SQL Server, e marque o arquivo para download.


Microsoft Visual C++ Redistributable

Microsoft Visual C++ Redistributable, baixe a versão mais recente do microsoft visual c++ 
Acesse https://support.microsoft.com/pt-br/topic/os-downloads-do-visual-c-mais-recentes-com-suporte-2647da03-1eea-4433-9aff-95f26a218cc0  Baixe a versão de acordo com o seu sistema operacional.

Card
labelErros e soluções

Objetivo

Este documento visa listar alguns erros que podem ser encontrados durante a instalação, configuração do portal, bem como suas possíveis soluções.

Aviso
titleImportante

Antes de analisar os itens de erros e soluções, convido você executar o “ambiente-check” do portal de imóvel, cujo seu propósito é realizar checagem de ambiente, permitindo avaliar possíveis inconsistência.

Para acessar, basta informar ao seu endereço do portal /ambiente-check.php
Exemplo: http://localhost:2205/ambiente-check.php


Lista erros e soluções:


Expandir
title404 Not Found

Mensagem de erro:





















  • Problema:
    Ao tentar logar no portal, é apresentado mensagem de erro:
    Desculpe, não foi possível processar sua solicitação neste momento.
    Se necessário, entre em contato com a equipe de TI ou administrador do sistema. Status: "404 Not Found".
    URL: ./api/login
  • Solução:
    Certifique a existência do arquivo web.config  em seu ambiente de instalação do portal. 
    Geralmente, é adotado o caminho fisico,  (C:\TOTVS\CorporeRM\FrameHTML\Web\App\Imb\PVI\API\ mas isso não é uma regra.

    Segue o padrão do Web.config

    Bloco de código
    languagexml
    themeEclipse
    titleWeb.config
    <configuration>
    <system.webServer>
        <rewrite>
            <rules>
              <rule name="ignore-ui" stopProcessing="true">
                <match url="^ui" />
                <action type="None" />
              </rule>
              <rule name="ignore-ui-json" stopProcessing="true">
                <match url="^pvi-openapi.json" />
                <action type="None" />
              </rule>
              <rule name="slim catch all" enabled="true">
                  <match url=".*" />
                  <action type="Rewrite" url="index.php" />
                  <conditions>
                      <add input="{URL}" pattern="sync*" negate="true" />
                  </conditions>
              </rule>
            </rules>
        </rewrite>
        <httpProtocol>
        <customHeaders>
          <add name="Access-Control-Allow-Origin" value="*" />
          <add name="Access-Control-Allow-Headers" value="*" />
        </customHeaders>
      </httpProtocol>
    </system.webServer>
    </configuration>
    
    
    Painel
    titleColor#FF9000
    titleNotas
    • Vale lembrar que, por padrão o compartilhamento de recursos com origens diferentes (CORS)  vai liberado.
      Caso seja necessário bloquear algumas destas configurações, o Web.config do portal de imóveis na pasta /PVI/api, deverá ser alterado. as tag's responsáveis são:

      Bloco de código
      languagexml
      themeEclipse
      titleCors
      <httpProtocol>
          <customHeaders>
            <add name="Access-Control-Allow-Origin" value="*" />
            <add name="Access-Control-Allow-Headers" value="*" />
          </customHeaders>
        </httpProtocol>


Expandir
title405 URL: /api/login

Mensagem de erro:


  • Problema:
    Ao tentar logar no portal, é apresentado mensagem de erro:
    Desculpe, não foi possível processar sua solicitação neste momento.
    Se necessário, entre em contato com a equipe de TI ou administrador do sistema. Status: "405 URL: /api/login".

    Solução:
    Acesse o IIS e em seguida ao selecionar o diretório do Portal (clique no ícone Gerenciador do PHP)


  • Neste momento selecione a promeira configuração para registrar o PHP,


    Selecione o caminho para carregar o PHP.exe e em seguida clique em abrir;


  • Em seguida selecione a opção Verificar PHPINFO



  • Será apresentado a menasgem informando que o PHP encontra-se corretamente configurado.

Expandir
titleSOAP-ERROR: Parsing Schema: can't import schema from

Mensagem de erro:

  • Problema:
    Neste momento deveremos informar o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.
  • Solução:
    Para expor os WebServices para acesso externo, torna-se necessária a inclusão da tag ServicesHostName, onde seu valor deverá ser o DNS ou IP Público da instituição.
    É provável que essa Tag no HOST do serviço RM esteja inconsistente.
    <add key="ServicesHostName" value="DNS da instituição" />
Expandir
titleFunction is not a valid method for this service

Mensagem de erro:

  • Problema:
    Ao tentar tentar ativar /inativar o empreendimento é apresentado mensagem de erro:
    Function
    ("SincronizaAtivacaoEmpreendimentoPortalDeImoveis") is not a valid method for this service

  • Solução:
    Certifique a a informação do parâmetro WebService TOTVS: URL. 
    Esse parâmetro, você o encontra no portal de imovel>> 
    Parâmetros - TOTVS >> WebService TOTVS: URLO dataserver utilizado deve ser o dataserverPVI, sendo assim o método SincronizaAtivacaoEmpreendimentoPortalDeImoveis será encontrado.
    Exemplo do caminho WebService TOTVS


Expandir
titleErro ao atualizar as páginas do módulo de Aluguel

Mensagem de erro:

  • Problema:
    Ao atualizar as páginas do módulo de Aluguel é apresentado a mensagem de erro:
    404 - Arquivo ou diretório não encontrado
    O recurso que você está procurando pode ter sido removido, ter tido seu nome alterado ou estar temporariamente indisponível.


  • Solução:
    Acesse o diretório de instalação do Portal de Imóveis (C:\...\CorporeRM\FrameHTML\web\app\Imb\PVI) e verifique na raiz da pasta o arquivo Web.config. Caso o arquivo não exista, o mesmo deve ser criado. Abra o arquivo e informe a seguinte linha no atributo da principal regra:

<action type="Rewrite" url="/aluguel/" />

Exemplo:


Expandir
titleO processo FastCGI excedeu o tempo limite de atividade solicitado

Mensagem de erro:

           Erro HTTP 500.0 - Internal Server Error C:\php\php-cgi.exe - O processo FastCGI excedeu o tempo limite de atividade solicitado

         

  • Problema:

Ao executar alguns processos dentro do portal e exceder o tempo de resposta do servidor.
Como exemplo, o processo de sincronização ou impressão de relatórios.

  • Solução:

 Acesse o IIS e em seguida selecione no servidor principal a opção de configuração de FastCGI



Ao acessar esta tela (ainda no IIS) marqui o caminho de configuração do FastCGI e clique em Editar...


Observe que na tela em aberto existem algumas informações com valores já pre determinados na instalação nativa do IIS.
Dentre estas opções altere o valor da propriedade "Tempo de Espera de Atividade" default 300 (esse valor padrão refere-se a segundos) dividindo o valor de tempo por 60 = 5 minutos. Este valor poderá ser definido pelo usuario. Uma vez alterado (clique em salvar).



Ferito estes ajustes, selecione novamente o servidor principal e clique na opção para reininciar os serviços do IIS;


Após realizar os ajustes via IIS, ainda deverá ser realizado outra parametrização, acessando no explorer o diretório onde encontra-se instalado o PHP.
Uma vez acessando o diretório edite o arquivo de inicialização PHP.INI (OBS: Por padrão o arquivo é encontrado no diretório: $:\totvs\PHP)
Com o arquivo editado localize a TAG "max_execution_time" (que possui o valor padrão 300) podendo ser aumentado de acordo com a necessidade do usuário, lembrando que este valor também refere-se a segundos.





Card
labelMigrar versão 3.7.X para superiores

Objetivo

Realizar a migração da versão 3.7.x para versões atualizadas acima da 12.1.x

Procedimentos:

  • Acesse o diretório de instalação do portal 3.7.x e copie as pastas: tmp e uploads;


  • Estas pastas (tmp e Uploads) deverão ser copiadas para o diretório onde o Portal de Imóveis encontra-se instalado no servidor, neste nosso exemplo, o portal encontra-se instalado em um diretório padrão de instalação: C:\totvs\CorporeRM\FrameHTML\web\app\Imb\PVI



  • Ao acessar o IIS será necessário parar o serviço do site da versão 3.7.x, mantendo iniciado somente o site da Versão 12.1.x que será o novo site que será parametrizado.
    Ao selecionar o novo site PVI (realize a configuração do PHP Manager para comunicaçao com esse novo portal).



  • PHP conectado com sucesso:



  • Quando selecionado o Site do PVI é necessário incluir a Permissão para o usuário IIS_IURS com as permissões totais para este usuário.



  • Validar a autenticação do usuário no Application pool, neste parametrização (Basic Settings) informar o usuário Administrador do IIS;



  • Realizar a instação do Conversor Word e Conversor PDF;



  • Acesse o diretório de instalação do Portal: C:\TOTVS\CorporeRM\FrameHTML\web\app\Imb\PVI\api (apague o arquivo: licença.lic). Em seguida acesse o Portal de Imóveis onde será necessário realizar as configurações conforme solicitadas na tela.


    Neste momento deveremos definir o caminho público da URL dos webservices TOTVS que serão consumidos pelo Portal de Imóveis.



  • Instalação concluída

    Nesta etapa será apenas um informativo com as configurações de login para o primeiro acesso no Portal de Imóveis.