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.
Aviso
title
Instalação em Bases Oracle
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
name
Instalando portal de imóveis.mp4
autostart
true
Painel
titleColor
#FF9000
title
Notas
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
A conexão com o Portal de Imóveis está homologada para ser configurada utilizando apenas o protocolo http:
Card
label
Configurando IIS
Objetivo
Esta página tem como objetivo descrever o processo de configuração do Portal de Imóveis utilizando IIS
PHP Manager é o software gerenciador do PHP para o IIS. Acessehttps://github.com/phpmanager/phpmanager/releasesvá 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 AcesseODBC Driver 17 for SQL Server,selecione o idioma do seu SQL Server. E marque o arquivo para download.
Durante a instalação do IIS, através do recurso "Ativar ou desativar recursos do Windows", recomendamos que a opção "Publicação WebDAV" seja desmarcada para evitar possíveis restrições na realização de chamadas PUT via API. Esse cuidado é especialmente importante para desenvolvedores que precisam alterar dados no portal por meio da API.
Card
label
Passo 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 pastaC:\TOTVS\CorporeRM\FrameHTML\web\app\Imb\PVI caminho que foi definido durante o processo de instalação do Portal de Imóveis
Card
label
Passo 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
label
Passo 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
label
Passo 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
label
Passo 6 - ORACLE
Configurando o arquivo de configuração do PHP para listar drivers do ORACLE.
Para clientes que utilizam banco de dados Oracle, é necessário realizar uma modificação no arquivo INI do PHP. Essa alteração permitirá que o servidor IIS liste os drivers OCI (Oracle Call Interface) do Oracle, permitindo a integração adequada com o banco de dados.
Para fazer essa alteração, siga os passos abaixo:
Localize o arquivo INI do PHP no seu servidor. Geralmente, ele está localizado na pasta de instalação do PHP ou em um subdiretório chamado "conf" ou "php.ini".
Abra o arquivo INI do PHP utilizando um editor de texto.
Procure a seção do arquivo INI relacionada à extensão OCI do Oracle. Pode ser chamada de "oci8" ou similar (são eles): extension=php_pdo_oci.dll extension=php_oci8.dll extension=php_oci8_12c.dll
Verifique se a linha correspondente ao driver OCI está comentada (iniciada com ponto e vírgula ";"). Se estiver, remova o ponto e vírgula para descomentá-la.
Certifique-se de que a configuração correta para o driver OCI esteja definida. Isso inclui informações como o caminho para a biblioteca do cliente Oracle (por exemplo, "oci.dll" ou "oci.so") e outros parâmetros relevantes.
Salve o arquivo INI modificado.
Após realizar essas alterações, reinicie o servidor IIS para que as modificações tenham efeito. Agora, o IIS será capaz de listar e utilizar os drivers OCI do Oracle (conforme imagem abaixo), permitindo a integração adequada com o banco de dados Oracle.
Card
label
Configurando o 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
id
Etapas do Wizard
Card
label
Passo 1
Sobre o instalador
Esta etapa é apenas uma introdução que resume os procedimentos que deverão ser executados
Card
label
Passo 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.
Usuário: Usuário de acesso ao webservice;
Senha: Senha do usuário
Card
label
Passo 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, SQLServer ou Oracle
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
label
Passo 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
label
Configurando a 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
title
Informaçã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
id
Configuracoes
Card
default
true
label
Configuraçã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.
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 ouRM.Host.Service.exe.config.
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 porta8052, caso esta seja utilizada para outra finalidade o departamento de TI deverá informar outra porta para uso.
Importante: Após alterar as configurações de portas é necessário reiniciar o serviço do Host.
Card
label
Configuraçã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
id
Etapas do Wizard
Card
label
Passo 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
firstline
1
title
config.json
linenumbers
true
{
"apiServer": "http://BHN050103554:8052/",
}
"apiServer": endereço da API do serviço do Host do RM
A porta da API deve estar preenchida com amesma portainformada naconfiguraçã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
title
Importante
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
label
Passo 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
title
Importante
A porta será informada na TAG: ApiPort do arquivo de configuração do Host: Exemplo: <add key="ApiPort" value="8052" />
Card
label
Passo 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
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:
PHP Manager é o software gerenciador do PHP para o IIS. Acessehttps://github.com/phpmanager/phpmanager/releasesvá para a opção Downloads e selecione o arquivo correto para a versão do seu sistema operacional (32 ou 64 bits)
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
title
Importante
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.
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.
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:
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
title
SOAP-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. Informe a URL do WebService TOTVS: Endereço do webservice. Exemplo: http://url:porta/wsDataServerPVI/MEX?wsdl Usuário: Usuário de acesso ao webservice; Senha: Senha do usuário Ao clicar em conectar, deparamos com a mensagem Erro retornado pelo TOTVS: SOAP-ERROR: Parsing Schema: can't import schema from 'http://url:porta/wsDataServerPVI/mex?xsd=xsd0'
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
title
Function 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
title
Erro 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
title
O 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) marque o caminho de configuração do FastCGI e clique em Editar...
Observe que na tela em aberto existem algumas informações com valores já pré 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 usuário. Uma vez alterado (clique em salvar).
Feito estes ajustes, selecione novamente o servidor principal e clique na opção para reiniciar 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
label
Migrar 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.