Instalando o PVI

De PROTOS
Ir para navegação Ir para pesquisar

Antes da instalação

É necessário gerar as licenças e baixar os componentes usados na instalação. Entre em contato com o comercial para que as licenças sejam geradas e com o suporte para solicitar os links dos arquivos necessários.

email: comercial@protos.inf.br

Este manual espera que o usuário que fará a instalação possua conhecimento na criação de bancos de dados usando o SQL Management Studio e gerenciamento de sites usando o Gerenciador do IIS.

Checklist para instalar o Portal de Vendas de Imóveis (PVI)

Checklist para instalação do PVI
ITEM STATUS
Servidor do PVI ter acesso a URL www.protos.inf.br nas portas 80 e 443
Servidor do PVI ter acesso a URL www.dropbox.bom nas portas 80 e 443
Servidor do PVI ter acesso a URL http://protospvi.totvs.com.br portas 80 e 443
MSUpdate (Microsoft Update) com acesso a fazer download de aplicativos Microsoft
Servidor do PVI ter acesso a URL http://www.cepaberto.com/ - http://postmon.com.br/ -
Servidor do PVI ter acesso a URL de validação do GEOCODE GOOGLE - https://maps.googleapis.com - http://maps.google.com/ - https://drive.google.com -
Browsers Google Chrome ou Mozila no servidor onde o PVI será instalado
Pacote de instalação do conversor PDF
Pacote de instalação do conversor WORD
Pacote de instalação do PVI
Definir o Gerenciador de banco de dados do PVI - SQL Server ou MYSql
Instalar o Gerenciador de Bando de Dados escolhido caso não exista
(TOTVS) Habilitar WebService no servidor do TOTVS
(TOTVS) Testar comunicação entre servidor do PVI e servidor TOTVS na porta do WebService definida
Executar pacote de instalação do Conversor PDF (instalar como Administrador)
Executar pacote de instalação do Conversor Word (Instalar como Administrador)
Executar pacote de instalação do PVI (Instalar como Administrador) e seguir as instruções de parametrização deste manual.
O servidor do PVI envia emails, portanto deve-se validar se este servidor possui liberação para o provedor de email da empresa
PVI necessita comunicar com o WebService da TOTVS portanto necessita de usuário no TOTVS com acesso a todo TIN, Cadatro de clientes, Gestão do Relacionamento com clientes e as rotinas globais

Requisitos de Hardware

  • Servidor dedicado com no mínimo 4GB de Memória (máquina virtual ou não)
  • Link de dados (acesso a internet)
  • IP fixo apontando para o servidor onde a aplicação será instalada

Requisitos de Sistema

  • Servidor Windows 2008 64 bits ou superior com biblioteca TOTVS RM Instalado
  • Usuário do servidor do banco de dados para acesso ao banco do TOTVS (leitura e gravação)
  • SQL Server 2008 R2 Express ou superior (pode estar no mesmo servidor ou não)
  • Usuário do TOTVS para ser usado no Web Service
  • Usuário com poderes administrativos na rede
  • Endereço de e-mail e parâmetros do servidor SMTP
  • Recomendado um SO formatado afim de evitar erros na instalação


  • Para a volta da venda para o TOTVS:
    • TOTVS versão 11.82.34.104 ou superior
    • Geração do ID do cliente automaticamente no TOTVS. (máscara de cliente numérica)
    • Parâmetro de venda sequencial no TOTVS Incorporação ligado.

OBS-INSTAL1.JPG

Instaladores

  • Instale o conversor de PDF
  • Instale o conversor do Word
  • Instale o PVI


Os links para os instaladores serão fornecidos via email.

Instalando o portal

SUGESTÃO: Execute o pacote de instalação clicando com o botão direito do mouse e rodando como administrador.

Ao abrir o instalador do portal será mostrado a tela abaixo. Siga os passos a seguir.

IMG1.png

Na tela seguinte clique em "Instalar" para iniciar o levantamento dos pré-requisitos necessários para a instalação do portal. OBS: Na primeira instalação marque todos os programas que são apresentados na tela mesmo o instalador não sugerindo.

IMG2.png

Selecione todos os pacotes para serem instalados:

INSTALADORPARAMETROS.JPG

Aguarde a finalização do processo de instalação dos pré-requisitos de software necessários, isto levará vários minutos, pois é o processo que envolve todas as parametrizações e configurações necessárias ao funcionamento do portal.

IMG3.png

Finalizada as parametrizações é apresentada a tela de conclusão do configurador. Clique em "Fim" e o gerenciador do IIS será aberto.

IMG4.png

Alterando o Application Pool

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

Expanda "Application Pools", selecione "Protos-PVI", 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.

IMG5.png

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.

APPPOOL.jpg

Registrando o PHP

Caso o PHP Manager não apareça, vá até Executar digite "iisreset" e pressione Enter. Reinicie o gerenciador do IIS.

Se mesmo assim o PHP nao aparecer baixe diretamente do link https://phpmanager.codeplex.com/

Clique em "Sites => Protos-PVI => PHP Manager". Ao abrir, selecione "Register new PHP Version".

IMG6.png
IMG7.png

Copie e cole "c:\protos\php\php-cgi.exe" e pressione ok.

IMG8.png

Após aceita a instalação a tela do IIS apresentará as configurações do PHP

IMG9.png

Aproveite para configurar o hostname. Sugerimos utilizar: pvi.nomedaempresa.com.br

Restaurando o banco de dados

O PVI pode ser executado em MYSQL 5.5 (ou superior) ou SQL Server 2008 express (ou superior).

1 - Instale o gerenciador de banco de dados de sua preferencia.

2 - Crie o banco de dados do PVI (sugestão de nome PVI)

3 - Aplique o collation - latin_general_ci_as(SQL) ou utf8_general_ci(MySql)

4 - Na pasta de instação do PVI (c:\inetpub\wwwroot\protos-pvi) haverá uma pasta denominada DB nela existirão os scripts de criação das tabelas do banco de dados criado na etapa 2. Execute o Script relacionado com seu banco de dados.

5 - Dê os devidos direitos para os usuários de login do banco sobre o banco criado

6 - Importante que a linguagem default do usuário de acesso ao banco do PVI seja Inglês.

Licenciamento e URL de instalação

É importante destacar que o PVI é licenciado por volume de empreendimentos e pela URL de instalação do produto, portanto se durante o processo de licenciamento (menu Configurando os primeiros passos), chamarmos o portal através de LOCALHOST:PORTA ou SERVIDOR:PORTA, o PVI será registrado para a URL http://localhost:porta ou http://servidor:porta e se a chamada externa ao produto (usuário externo a empresa que deseja abrir o portal) for pvi.empresa.com.br:8080, o portal apresentará uma mensagem de erro informado que o endereço chamado não possui licenças e não permitirá a abertura do site.

Para impedir este problema, antes de iniciar o processo de licenciamento, saiba:

  1. Nome da URL de acesso externo ao produto, pois no licenciamento o portal irá ler o nome que está na barra de URL do Browser para gravar a licença.
  2. Se você ainda não possuir o redirecionamento da URL pelo seu DNS Externo, acesse a pasta WINDOWS/SYSTEM32/DRIVERS/ETC e edite o arquivo HOSTS e acrescente a linha:
  • 127.0.0.1 pvi.empresa.com.br (onde pvi.empresa.com.br é o nome da URL que será utilizada para chamar o portal)

Após este processo todas as chamadas ao PVI no servidor onde este foi instalado deverá ser utilizando a URL escolhida. Desta forma a URL ficará gravada no arquivo de licenciamento evitando erro quando demais usuários forem acesssar o produto externamente.

Testando a Instalação

Permissões corretas é a chave para o sucesso da instalação e do uso do PVI, portanto devemos seguir os passos abaixo:

1 - Dê acesso total ao usuário administrador local e ao administrador da rede na pasta C:\INETPUB\WWWROOT\PROTOS-PVI (clique com botão direito na pasta e selecione a guia segurança como nas imagens abaixo)


2 - Para validar se a instalação está correta, acesse a URL http://localhost/ambiente-check.php (onde localhost é a URL da instalação)

Possíveis mensagens de erro:

  • A pasta não possui permissão de escrita.

Dê permissão de leitura e gravação para o usuário IIS_IUSRS e ao grupo IUSR na pasta mencionada. Para isto, acesse PROPRIEDADES das pastas mencionadas e clique em SEGURANCA e permita ao usuário IIS, acesso de gravação e leitura nas pastas.

USUARIO PASTA.JPG


Caso o ambiente esteja parametrizado corretamente aparecerá a mensagem:

TESTEINSTAL1.jpg

Configurando os primeiros passos

Certificando que o ambiente está configurado corretamente, basta acessar o endenreço onde o portal foi instalado para validar o licenciamento e o primeiro acesso ao portal. Para isto acesse http://localhost (onde localhost é a URL de instalação do portal).

Caso o sistema não carrege as telas abaixo isto indica que algum componente não foi instalado corretamente, portanto voce deve checar os seguintes pacotes se estão instalados:

  • MICROSOFT SQL SERVER 2012 NATIVE CLIENT - Abra o painel de controle e verifique se o pacote está instalado
  • MICROSOFT C++ 2012 REDISTRIBUTABLE VERSAO 11.0.61030 ou maior - Abra o painel de controle e verifique se o pacote está instalado.

Não encontrando os pacotes uma sugestão é executar novamente o instalador do PVI clicando com o botao direito do mouse e executando como administrador e marcar todos os pacotes de instalação. So conseguiremos avancar para a próxima etapa se os pacotes mencionados estiverem instalados.

Estando tudo certo no primeiro acesso será apresentada a tela abaixo, siga as instruções:

TESTEINSTAL2.jpg


Na janela de validação de licenças, digite o CNPJ da empresa que adquiriu as licenças. Após a digitação o sistema validará as o limite de licenças adquiridas.
Ative o portal com o domínio definitivo, pois a licença é por domínio.

OBS: para validar as licenças adquiridas é importante ter acesso a internet.

TESTEINSTAL3.jpg


Ao demonstrar as licenças, clique em salvar licenças

TESTEINSTAL4.jpg


Após a validação das licenças, o portal pedirá para validar o endereço do servidor de banco de dados, nome do banco de dados do portal, usuário e senha de acesso a estes.
Caso não consiga conectar, verifique se o protocolo TCP/IP está ativado para o IP do servidor em SQL Server Configuration Manager.

TESTEINSTAL5.jpg


Após a entrada das informações do banco de dados clique em "Testar Conexão" se os parâmetros estiverem corretos o botão avançar será liberado para clicar. Neste momento o portal solicitará a restauração do banco de dado, caso o banco já tenha sido restaurado este passo avançará automaticamente.

TESTEINSTAL6.jpg


Se o processo de configuração estiver correto teremos uma resposta positiva, o portal estará pronto para o primeiro acesso.

TESTEINSTAL7.jpg

Configurando o WebService TOTVS

O portal de vendas acessa informações do banco de dados TOTVS utilizando os Web Services nativos no Host do produto, portando demonstraremos a seguir como habilitar este serviço.

OBS: Importante que a biblioteca do RM esteja instalado no mesmo servidor do IIS, nesta máquina a instalação deve ser "local" mesmo que seu ambiente seja em 3 camadas.

  1. Acesse a pasta C:\totvs\CorporeRM\RM.Net
  2. Edite o arquivo RM.HOST.SERVICE.EXE.CONFIG e em <appsettings> acrescente as linhas abaixo:
    1. <add key="DefaultDB" value="CORPORERM" /> Obs: COLOQUE O NOME DO ALIAS DO BANCO UTILIZADO PELO RM
    2. <add key="HTTPPORT" value="8051" />
    3. <add key="ServicesHostName" value="187.94.63.179" /> Obs: NO CAMPO VALUE COLOQUE O IP DO SERVIDOR ONDE ESTÁ O WEBSERVICE - utilize esta TAG principalmente para ambientes cloud
  3. Agora edite o arquivo RM.HOST.EXE.CONFIG e em <appsettings> acrescente a linha:
    1. <add key="DefaultDB" value="CORPORERM" /> Obs: COLOQUE O NOME DO ALIAS DO BANCO UTILIZADO PELO RM
    2. <add key="HTTPPORT" value="8051" />
    3. <add key="ServicesHostName" value="187.94.63.179" /> Obs: NO CAMPO VALUE COLOQUE O IP DO SERVIDOR ONDE ESTÁ O WEBSERVICE utilize esta TAG principalmente para ambientes cloud
  4. Pare o serviço RM.HOST.SERVICE através do aplicativo da TOTVS RM.Host.ServiceManager.exe que se encontra na mesma pasta.
  5. Elimine o arquivo _Broker.dat que se encontra na pasta C:\totvs\CorporeRM\RM.Net
  6. Reinicie o serviço RM.HOST.SERVICE
  7. Para validar se o processo foi configurado corretamente acesse a página:
    1. http://localhost:8051/wsPageIndex/

Caso o serviço esteja habilitado, a tela abaixo será apresentada como resultado da URL digitada. Refaça todo procedimento "Configurando WEB Services TOTVS", caso o resultado não seja o apresentado neste manual. Caso o procedimento não funcione desinstale o serviço utilizando o aplicativo TOTVS RM.Host.ServiceManager.exe e reinstale trocando a conta de sistema..

TOTVWS1.jpg


OBS: Caso não consiga habilitar o WebServices favor executar o comando abaixo, utilizando o prompt de comando do windows:

netsh http add urlacl url=http://+:8051/ user=NetworkService

Segue link do TOTVS explicando a configuração do WebService: http://tdn.totvs.com/pages/releaseview.action?pageId=89620766

Preparando o TOTVS RM para receber o portal de vendas

Para iniciar a configuração do PVI devemos fazer alguns processos no Totvs RM.

1 - Iniciamos o processo com a atualização das actions do sistema. Para isto devemos acessar o menu de "Serviços Globais" e depois selecionar "Actions do Sistema"

2 - Ao abrir a tela de actions, selecione o menu de "Processos" e selecione "Atualização de Actions Cadastradas"

ACTIONS1.png

3 - Ainda no menu de "Serviços Globais", acesse a opção de "Servidores de Aplicação" e no menu "Processos" selecione "Carregar dados de descrição dos serviços". Este procedimento pode demorar até 5 minutos, favor acompanhar a janela de mensagens no rodapé do TOTVS.

ACTIONS2.png

4 - As etapas de 5 até 6 deverão ser executadas para todos os itens listados em notas do item 6. Este processo habilita os webservices a mostrarem mais do que a quantidade padrão de registros na visão. Vá novamente em "Serviços Globais", "Servidor de Aplicação". Ao abrir a tela clique no botão para inserir registro.

5 - Clique no botão para listar os ID´s dos servers cadastrados. Ao abrir a janela de pesquisa, digite no campo descrição o nome "GLBBKSERVERDATA". Selecione o registro que aparecer com esta descrição e tecle OK.

ACTIONS3.png

6 - Na tela de cadastro, coloque o valor "-1" no campo "Número máximo de registros" e clique em Salvar.

ACTIONS4.png

NOTA: repita os procedimentos 5 e 6, parametrizando todas as actions que serão utilizadas na integração entre o TOTVS e o Portal de Vendas, sendo:

Pra versões do TOTVS RM até 11.82

  • FinCFODataBR
  • GlbBKServerData
  • ImbClientePessoaFisicaData
  • ImbComponenteModalidadeVendaData
  • ImbCompradorData
  • ImbDistratoContratualData
  • ImbEmpreendimentoData
  • ImbEmpreendimentoModalVendaData
  • ImbGerarPlanoDeFinanciamentoWSProc
  • ImbModalidadeVendaData
  • ImbPessoaConjugeData
  • ImbProfissaoData
  • ImbRegiaoData
  • ImbRegimeCasamentoData
  • ImbRegraComponenteVendaData
  • ImbSituacaoSubUnidadeData
  • ImbSubUnidadeData
  • ImbTabelaPrecoData
  • ImbTabelaPrecoSubUnidadeData
  • ImbTipoComponenteData
  • ImbTipoParcelaData
  • ImbUnidadeData
  • ImbVagaData
  • ImbVendaData
  • ImbVendedorData

Para versões do TOTVS RM a partir da 12 acrescentar:

  • ImbVendaEmpreendimentoModalidadeData
  • ImbVendaEmpreendimentoData
  • ImbVendaEmpreendimentoUnidadeData
  • ImbVendaEmpreendimentoUnidadeSubunidadeData
  • ImbVendaEmpreendimentoUnidadeSubunidadeVagaData
  • ImbVendaGerarPlanoDeFinanciamentoProc
  • ImbVendaModalidadeRegraData
  • ImbVendaContratoData
  • ImbVendaModalidadeTipoParcelaData
  • FisMunicipioData
  • EstPrdDataBr
  • FinLanDataBR
  • ImbVendaCompradorData
  • ImbVendaTabelaPrecoSubUnidadeData

Parametrização do TOTVS para integração das vendas

Para que possamos integrar automaticamente a venda do portal no TOTVS Incorporação, necessitamos que alguns parâmetros do TOTVS esteja conforme abaixo:

TOTVS Incorporação

  • Marcar o parâmetro venda sequencial

TOTVS Incorporação

  • Criar outras situações de unidades.
    • Código 441 - Em Assinatura
    • Código 442 - Contrato Assinado
    • Código 801 - Em Correção
    • Código 802 - Em Proposta

TOTVS Financeiro

  • Numeração automática de Clientes/Fornecedores


Cadastro de Midias

O PVI utiliza do cadastro de midias, lendo os dados do TOTVS no GESTÃO DE RELACIONAMENTO COM CLIENTES.

GESTAORELACIONAMENTOCLIENTES.jpg

Para cadastrar as mídias desejadas acesse o Menu Marketing e a opção ORIGEM DE CONTATO e cadastre as midias que serão visualizadas no PVI.

ORIGEMCONTATO.JPG

OBS: Em breve o PVI terá o cadastro das mídias diretamente no portal.

Instalando uma nova copia do PVI no mesmo servidor

Quando já possuimos o PVI instalado, criar uma copia de teste do mesmo é simples e basta seguir as etapas abaixo:

OBS: Ao finalizar o processo o PVI novo somente será ativado se houver licenças disponíveis.

1) Duplique o banco de dados do PVI de produção para um PVI TESTE

2) Copie a pasta onde o PVI está instalado e renomeie para PROTOS-PVI-TESTE por exemplo. Por padrão esta pasta é a C:\INETPUB\WWWROOT\PROTOS-PVI

3) Na pasta copiada abra a pasta API e edite o arquivo CONFIG_DB.PHP mudando os dados de acesso ao banco de dados do PVI-TESTE.

4) Apague da pasta copiada API o arquivo LICENCA.LIC

5) Abra o IIS - Gerenciador de serviços de internet (Internet Information Services Manager) e clique com botão direito do mouse sobre o item SITES e ADICIONE NOVO WEBSITE. Digite o nome deste novo website selecione a pasta para onde foi copiado o PVI como caminho de onde o site irá ler o programa. Defina uma porta diferente das portas utilizadas no IIS nos demais SITES e deixe o hostname em branco.

Esta instalação permitirá acesso ao novo PVI somente local no servidor onde o mesmo foi instalado sendo chamado através de http://localhost:<porta>. Execute o novo PVI que ele abrirá a tela de instalação mas somente para solicitar a licença para o novo site.