Linha Datasul

Árvore de páginas

Tutorial de Instalação do Foundation

Visão Geral do Programa

Este tutorial tem como objetivo trazer de forma simples os passos da instalação do Totvs Foundation. Em caso de dúvidas, consulte os manuais completos no portal de download da totvs.

Seguem os passos para a instalação do produto abaixo:

Procedimentos

 
  1. Descompacte o "arquivo.zip", referente a mídia do Foundation e execute o arquivo "setup.exe".
  2. Clique em "Avançar", na tela de boas vindas do produto.
  3. Insira informações iniciais e clique em "Avançar".
  4. Selecione a integração com o "Gestão de Planos" e clique em "Avançar".
  5. Selecione o banco "Progress" e clique em "Avançar".
  6. Indique a pasta "ERP", referente a instalação do "Totvs 12", parametrizado com o "Gestão de Planos".
  7. Insira as informações de "host" e "porta" do servidor "Progress", onde será instalado o banco do Foundation, feito isto  clique em "Avançar".
  8. Informe o "host" do servidor onde ficará parametrizado o "AppServer" do foundation, em seguida clique em "Avançar".
  9. Caso o seu "AppServer" seja configurado no mesmo servidor que o Foundation, selecione a primeira opção e clique em "Avançar".
  10. Aguarde o produto finalizar o "wizard", e após clique em "Concluir".
  11. Após concluir o "wizard" de instalação, inicie o banco do Foundation por meio do script "C:\Totvs\foundation-saude\database\start.bat".

  12. Certifique-se que o servidor reconhece o "hostname" que o Foundation fará o "bind". Uma forma simples de ajustar o endereço localmente sem a necessidade do update nos registros de "DNS", é editar o arquivo "C:\Windows\System32\drivers\etc\hosts", manualmente no Windows. Neste exemplo, o "hostname" público na internet será foundation.totvs.com.br , vamos apontar para o IP local do servidor (10.54.252.20) . Importante ressaltar que esta configuração é necessária somente no servidor "JBOSS", ou seja, não faça em outros servidores.

    # Copyright (c) 1993-2009 Microsoft Corp.

    #

    # This is a sample HOSTS file used by Microsoft TCP/IP for Windows.

    #

    # This file contains the mappings of IP addresses to host names. Each entry should be kept on an individual line. The IP address should

    # be placed in the first column followed by the corresponding host name.

    # The IP address and the host name should be separated by at least one space.

    #

    # Additionally, comments (such as these) may be inserted on individual lines or following the machine name denoted by a '#' symbol.

    #

    # For example:

    #

    #      102.54.94.97     rhino.acme.com          # source server

    #       38.25.63.10     x.acme.com              # x client host

     

    # localhost name resolution is handled within DNS itself.

    #             127.0.0.1             localhost

    #             ::1                          localhost

    10.54.252.20                      foundation.totvs.com.br

    Após ajustar o arquivo “hosts”, é hora de ajustar o arquivo de start do "JBOSS": "C:\Totvs\foundation-saude\jboss-4.2.3.GA\bin\start.bat", conforme o exemplo abaixo.

  13.  Para configurar o TISS no Foundation, abra o arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\conf\tiss.ini". Todos os parâmetros do arquivo são explicados nos comentários acima de cada parametrização.
    Atenção para os parâmetros listados abaixo:     

    tiss.versao.atual=3.02.01

    tiss.schema=tissV3_02_01.xsd

    tiss.versao.anterior=2.02.03

    tiss.schema.anterior=tissV2_02_03.xsd

    com.datasul.saude.foundation.payerType=ANS

    com.datasul.saude.foundation.payerCode=111111

    tiss.timeout.soquete=200000

    OBS: São os parâmetros que mais apresentam divergência listados pelo time de atendimento com exemplo de configurações.

     

  14. Para configurar o "SIB", abra o arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\deploy\properties-service.xml" e adicione os seguintes parâmetros dentro da tag "<attribute name="Properties>".

     

    sib.connector=GPS

    sib.generated.dir=C:\Totvs\foundation-saude\sib\generate

    sib.ans.cnpj=11111111111111

    sib.ans=111111


  15. Para configurar o "PTU", é necessário ter previamente um certificado emitido pela Unimed do Brasil, tanto para protótipo quanto produção. Também é necessário ter o endereço publicado na internet para que seja possível a comunicação entre a Unimed do Brasil e o Foundation. Para configurar o certificado, é necessário parametrizar 3 arquivos:
    a) No arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\conf\jboss-service.xml", ajuste  o "mbean" <mbean code="org.jboss.security.plugins.JaasSecurityDomain" name="jboss.web:service=SecurityDomain> de acordo com os dados do seu certificado.

     

    <mbean code="org.jboss.security.plugins.JaasSecurityDomain" name="jboss.web:service=SecurityDomain">

                <constructor>

                    <arg type="java.lang.String" value="JBossWS-SSL" />

                   </constructor>

                <attribute name="KeyStoreURL">${jboss.server.home.dir}/conf/certificado_recebido.keystore</attribute>

                        <attribute name="KeyStorePass">senha_do_certificado</attribute>

                        <attribute name="TrustStoreURL">${jboss.server.home.dir}/conf/ certificado_recebido.keystore </attribute>

                        <attribute name="TrustStorePass"> senha_do_certificado </attribute>

           <depends>jboss.security:service=JaasSecurityManager</depends>

        </mbean>

    b) No arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\deploy\properties-service.xml",  no atributo <attribute name="Properties>, insira as informações do seu certificado.

    javax.net.ssl.keyStore=${jboss.server.home.dir}/conf/ certificado_recebido.keystore

    javax.net.ssl.keyStorePassword= senha_do_certificado

    javax.net.ssl.trustStore=${jboss.server.home.dir}/conf/ certificado_recebido.keystore

    javax.net.ssl.trustStorePassword= senha_do_certificado

     

     c) No arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\deploy\jboss-web.deployer\server.xml", no conector “<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true>", insira as informações do seu certificado.

     <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true"

     

                                                                   maxThreads="150" scheme="https" secure="true"

     

                                                                   keystoreFile="${jboss.server.home.dir}/conf/ certificado_recebido.keystore "

     

                                                                   keystorePass=" senha_do_certificado "

     

                                                                   clientAuth="want" sslProtocol="TLS"

     

                                                                   truststoreFile="${jboss.server.home.dir}/conf/ certificado_recebido.keystore "

     

                                                                   truststorePass=" senha_do_certificado "/>

  16. Acesse o "Open Edge Admin" do servidor onde o "AppServer" será configurado, por padrão ele é acessado via protocolo "http" na porta: "9090".
  17. Clique em "AppServer", após clique em “Add Resource”, “New” e AppServer na coluna direita.
  18. Coloque o nome conforme informado no instalador e clique em "Save".
  19. Clique em "OK", na tela de aviso.
  20. Na tela principal do "AppServer HTZFoundation”, clique no botão “Configuration”.
  21. Clique no botão “Edit”.
  22. Na guia “Broker”, ajuste o campo “Port number” para uma porta que não conflita com os outros serviços. Em seguida clique na guia “Agent”.

  23. Na guia “Agent”, preencha os campos conforme as instruções abaixo:
    No campo "PROPATH", cole o mesmo "PROPATH" utilizado no "AppServer" e utilizado no seu "ERP" Totvs.
    Para este tutorial, utilizaremos o seguinte "PROPATH" :

    C:\totvs\datasul\dts-0\ERP,C:\totvs\datasul\dts-0\ServidorAplicacao\jboss-4.2.3.GA\server\instance-8080\conf\datasul,C:\totvs\datasul\dts-0\ERP\fnd,C:\totvs\datasul\dts-0\ERP\ems2,C:\totvs\datasul\dts-0\ERP\ems5,C:\totvs\datasul\dts-0\ERP\hcm,C:\totvs\datasul\dts-0\ERP\eai,C:\totvs\datasul\dts-0\ERP\eai2,C:\totvs\datasul\dts-0\ERP\gp,C:\totvs\datasul\dts-0\ERP\crm,C:\totvs\datasul\dts-0\ERP\crm\database,C:\totvs\datasul\dts-0\ERP\crm\integracoes

    No campo “Server startup parameters”, insira o caminho para o ".PF", de acordo com o exemplo abaixo:

    -pf "C:\totvs\datasul\dts-0\ERP\scripts-8080\datasul.pf"

    No campo “Startup procedure”, insira o caminho do "ALIAS" do seu ambiente, conforme exemplo abaixo:

    C:\totvs\datasul\dts-0\ERP\scripts-8080\datasul-appserver-alias.p

    Após concluir as configurações, clique em “Save”.

  24. Clique novamente no "AppServer HTZFoundation” e em seguida clique em “Broker Control”.
  25. Clique em “Start AppServer”.
  26. Aguarde até o status ficar como "ACTIVE". Caso demore muito (mais de 2 min), analise os logs a procura de inconsistência.
  27. Abra o navegador  e digite a url:" http://seuservidor.com.br/htz", após digite o usuário: "medical" e senha: "medical".

  28. Ao efetuar o primeiro logon, o produto irá exigir um CNPJ e uma chave de implantação, da qual deverá ser solicitada ao suporte da Totvs. Abra um chamado informando o CNPJ, e o time de suporte retornará com a chave de implantação.

    OBS1: Os dados de configuração do "LicenseServer", não precisam ser preenchidos.
    OBS2: No campo módulo, informe "HTZ".

  29. Pronto, a partir desta dela você já pode configurar as parametrizações inicias.



  30. Informações importantes:

    1. Verifique no arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\server\default\deploy\progress-ds.xml", se os apontamentos para o seu banco como "host", "porta", "usuário' e "senha" estão corretos.
    2. Caso deseje instalar o Foundation como um serviço, execute o arquivo "C:\Totvs\foundation-saude\jboss-4.2.3.GA\bin\service_install.bat".
    3. Verifique no arquivo ".PF", que o "AppServer" utiliza, se está conectado nos bancos do gestão de planos, do "ems5" e no banco "emsfnd".