Escolar Documentos
Profissional Documentos
Cultura Documentos
Montagem Ambiente Protheus e RM (C272098) PDF
Montagem Ambiente Protheus e RM (C272098) PDF
Processo : Ambiente
um documento geral que no aborda a parte de configurao da integrao em si. Aps a montagem do
ambiente, devem ser realizadas as configuraes referentes a integrao que se encontram na especificao
da mesma.
Contedo
1. Pr Requisitos .................................................................................................................................................................... 2
1.1 Obtendo Arquivos ............................................................................................................................................................... 2
1.2 Atualizaes Protheus ......................................................................................................................................................... 2
2. Instalao .......................................................................................................................................................................... 4
2.1 Protheus .............................................................................................................................................................................. 4
2.2 DBAcces ............................................................................................................................................................................... 5
3. Configurao...................................................................................................................................................................... 8
3.1 Protheus Parte 1 ............................................................................................................................................................... 8
3.2 Configurando Banco SQL ................................................................................................................................................... 10
3.3 Configurando Banco Oracle ............................................................................................................................................... 14
3.4 Configurando Conexes no DBAcces ................................................................................................................................. 19
3.5 Protheus Parte 2 ............................................................................................................................................................. 24
3.6 TOTVS Business Connect ................................................................................................................................................... 32
3.7 Painel de Controle ............................................................................................................................................................. 32
3.8 Internet Information Services (IIS) .................................................................................................................................... 33
3.9 Web.config ........................................................................................................................................................................ 38
DESENVOLVIMENTO/PROCEDIMENTO
1. Pr Requisitos
Protheus verso 11
RM verso 11.80
Oracle 10G | Microsoft SQL Server 2008
Nota: instale o Oracle 10G e o MSSQL caso deseje montar um ambiente com os dois tipos de banco.
Caso contrario escolha um.
DBAcces
IIS
SqlDbx, Developer, SQL Tools, etc.
Nota: Qualquer ferramenta para comunicar com o Banco de dados Oracle.
SOAP UI
Nota: para auxiliar na validao referente mensagem nica caso a integrao utilize a mesma.
As verses mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:
RPO: Protheus11\1-apo-BRA-CHI-EUA-PAR-URU\topconnect
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho D-1.
Updates: Protheus11\2-update-BRA-CHI-EUA-PAR-URU\topconnect
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho D-1.
D-1: \\172.16.103.229\d-1
um diretrio onde so armazenadas as compilaes dirias do Protheus. Semelhante a CM do RM.
Esta pasta e atualizada automaticamente com os ltimos fontes liberados no TFS. Selecione a pasta
P11.
ATUSX: \\172.16.93.23\temp
um diretrio onde so disponibilizados diariamente as ultimas verses dos dicionrios, dos menus
e dos arquivos de help cadastrados no ATUSX.
ATUSX: Gerenciador de base de dados, helps e CHs. O ATUSX a ferramenta utilizada na criao e
manuteno de:
Dicionrios:
ndices (SIX) Gatilhos (SX7)
Perguntas (SX1) Relacionamentos (SX9)
Arquivos (SX2) Pastas (SXA)
Campos (SX3) Consultas Padro (SXB)
Tabelas genricas (SX5) Grupo de campos (SXG)
Parmetros (SX6)
Arquivos .CH
Menus do sistema
Tabelas Padro
Help de campos e mensagens
2. Instalao
2.1 Protheus
Execute o instalador do Protheus e selecione a opo TOTVS | Application Server. A instalao bem intuitiva.
Concluda a instalao, acesse o diretrio onde esta o Protheus e localize a pasta bin\appserver. Crie um atalho na
rea de trabalho para o appserver.exe. Localize a pasta bin\smartclient e faa o mesmo para smartclient.exe.
Selecione o atalho do appserver na rea de trabalho e abra as propriedades do mesmo. No campo Destino insira no
final do caminho: -console.
Selecione tambm o atalho do smartclient e abra as propriedades do mesmo. No campo Destino insira no final do
caminho: -m. Isso ir permitir abrir mais de uma instncia do smartclient.
2.2 DBAcces
Execute novamente o instalador do Protheus e selecione a opo TOTVS | DBAcces. A instalao bem intuitiva.
Aps abra o local onde foi instalado o DBAcces.exe, e no caminho do diretrio, insira no final install.
Observao:
Outra maneira de configurar o DBAcces sem instalar como servio :
Abra a pasta onde o DBAcces foi instalado e crie um atalho do DBAcces.exe e do DBMonitor.exe na rea de
trabalho. Selecione o atalho do DBAcces e abra as propriedades do mesmo. No campo Destino, no final do
caminho insira: -console.
Aps basta iniciar o DBAcces:
Importante!! Quando o DBAcces iniciado dessa forma, sempre que for fechar necessrio digitar CTRL + C,
e YES para confirmar. Aps necessrio aguardar o aplicativo fechar sozinho. Este procedimento deve ser
realizado para no dar inconsistncias na base.
3. Configurao
Para criar um ambiente com dois tipos de bancos, acesse o diretrio do Protheus, pasta apo: C:\TOTVS
11\Microsiga\Protheus\apo
Nota: Escolha o arquivo que corresponda ao ambiente que deseja criar. Neste caso, o arquivo refere-se ao
topconnect, linguagem portuguesa, verso 110. A nomenclatura dos arquivos RPO est detalhada no incio do
documento, na parte de Atualizaes Protheus.
Observao:
Caso esteja montando ambiente apenas para um tipo de banco, basta no criar as pastas ORACLE e MSSQL,
e copiar o arquivo RPO direto para a pasta Protheus\apo
Para um ambiente com os dois tipos de banco, faa uma cpia da pasta Protheus_Data e renomeie uma pasta para
Protheus_oracle e a outra Protheus_mssql.
Para o RM, restaure e configure a base desejada normalmente. Para o Protheus no necessrio restaurar uma
base. O Protheus cria as tabelas necessrias para o seu funcionamento de forma automtica, sendo necessria
apenas a configurao apontando para uma database vazia.
Para criar uma nova database no SQL Server conecte-se no mesmo, clique com o boto direito em cima de
Databases e selecione New Database.
Informe o nome da base no campo Database name e clique em ok.
As bases foram criadas.
Para a base Protheus necessrio criar um ODBC com o programa odbcad32. Abra o programa, selecione a aba
Fonte de Dados de Sistema, e clique em Adicionar.
Obs* em mquinas com Windows 64bits, dever ser executado o ODBC do caminho:
C:\Windows\SysWOW64\odbcad32.exe
Clique em Avanar.
Selecione Alterar o banco de dados padro para, escolha a base de dados protheus e clique em Avanar.
Uma janela contendo o resumo da nova fonte de dados exibida. Clique no boto Testar fonte de dados... para
validar a conexo.
Caso tudo tenha sido configurado corretamente o teste ser realizado com sucesso, como mostra a imagem abaixo:
Da mesma forma que no SQL, so necessrias duas instncias, uma para o RM e outra para o Protheus.
Para o RM, restaure e configure uma base de dados normalmente. Para o Protheus, iremos configurar um novo
schema no Oracle. Para isso temos que criar um usurio que ser utilizado pelo Protheus. Utilize uma ferramenta
para acessar a instncia oracle criada para o RM. O comando que ser executado deve ser rodado com o usurio sys
ou system.
-- USER SQL
CREATE USER usurioProtheus IDENTIFIED BY senhaProtheus
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP;
-- ROLES
GRANT "RESOURCE" TO usurioProtheus WITH ADMIN OPTION;
GRANT "DBA" TO usurioProtheus WITH ADMIN OPTION;
GRANT "CONNECT" TO usurioProtheus WITH ADMIN OPTION;
ALTER USER usurioProtheus DEFAULT ROLE "RESOURCE","DBA","CONNECT";
-- QUOTAS
ALTER USER usurioProtheus QUOTA UNLIMITED ON SYSTEM;
Nota: Altere usurioProtheus para o nome do usurio que deseja criar, e senhaProtheus para a senha do usurio.
Para validar se o usurio foi criado, basta logar na mesma instncia informando o usurio e senha.
Aps a criao do usurio do protheus devemos configurar uma nova nomeao de servio na ferramenta Oracle
Net Manager.
Selecione a pasta Nomeao de Servio no Net Manager e clique em + para criar uma nova nomeao.
Clique no boto Alterar Login e informe o nome do usurio e senha criados com o script anteriormente. Clique no
boto Ok.
Aps clique em Testar. Caso a configurao tenha sido executada corretamente o teste de conexo ser bem
sucedido.
Clique em Fechar para fechar a tela de testes e depois clique em Finalizar para concluir a instalao.
Importante!
Antes de encerrar a aplicao selecione o menu Arquivo | Salvar Configurao de Rede para salvar a
configurao realizada.
Aps a criao e configurao do database/schema temos que configurar as conexes no TOTVS DBAccess. Ele a
ferramenta utilizada pelo Protheus para fazer a comunicao entre o appserver e o SGBD.
Inicialize o DBAcces.
Observao
Se o DBAcces foi instalado como servio verifique se o mesmo esta ativo.
Caso tenha sido configurado da outra forma, execute o DBAcces atravs do atalho.
Para configurarmos a conexo Oracle utilizaremos a aba Configuraes e depois a aba Oracle. Clique no boto
Novo e informe a base protheus, o nome do usurio e a senha.
Fazemos isto atravs do arquivo DBAccess.ini no diretrio onde foi instalado o DBAcces. Edite o arquivo e
acrescente a propriedade clientlibrary abaixo da chave [Oracle].
Exemplo:
[ORACLE]
clientlibrary=C:\oracle\product\11.2.0\client_1\oci.dll
environments=protheus,P11
Nota: a propriedade clientlibrary deve ser igual ao caminho onde esta instalada a dll oci.dll. Podendo variar
conforme escolha do diretrio de instalao do DBAcces.
Aps finalizarmos a configurao das conexes podemos realizar o teste das mesmas atravs da aba Assistentes.
Clique no boto Validao de Conexo.
Clique em Avanar. Selecione o SGBD e clique em Avanar. Informe o nome da conexo criada e clique em
Finalizar.
Se a conexo foi configurada corretamente ser mostrada a janela a seguir.
Nesta segunda parte da configurao do Protheus, iremos configurar o arquivo appserver.ini. Ele se encontra na
pasta appserver, no diretrio onde foi instalado o Protheus: C:\TOTVS 11\Microsiga\Protheus\bin\appserver
Seo Environment
[Environment]
SOURCEPATH=pasta onde se encontra o RPO
ROOTPATH=pasta protheus data
STARTPATH=nome da pasta system
RPODB=tipo de conexo (TOP)
RPOLANGUAGE=linguagem do RPO (Portuguese)
RPOVERSION=verso do RPO (110)
LOCALFILES=tipo dos arquivos locais (ADS)
LOCALDBEXTENSION=extenso das tabelas locais (.dbf)
PICTFORMAT=DEFAULT
REGIONALLANGUAGE=localizao (BRA)
TOPSERVER=endereo do DBAccess
TOPPORT=porta do DBAccess (7890)
TOPDATABASE=banco de dados (MSSQL/ORACLE)
TOPALIAS=alias do banco protheus
Notas:
o Algumas propriedades podem se encontrar na sesso DBAcces. Neste caso, retire as mesmas
dessa sesso e transfira-as para a sesso Environment, inserindo TOP na frente. A sesso DBAcces
deixa de existir.
o Altere o nome Environment por um nome que represente a conexo que est sendo criada.
o Caso esteja montando dois ambientes Oracle e MSSQL basta criar outra seo Environment,
renomeando a mesma.
[GENERAL]
InstallPath=pasta do Protheus
console=loga no console (0/1)
BuildKillUsers=desconecta todos os usurios quando compilar o RPO (0/1)
LogEnable=habilitar arquivo de log (0/1)
ConsoleLog=loga no console (0/1)
consolemaxsize=tamanho mximo do log (10000000)
ConsoleFile=arquivo de log
Segmento=cYdTm3WWERZF=1hu
Serie===AV
Seo de Servio
[SERVICE]
Name=Protheus11
DisplayName=Protheus 11
[TCP]
TYPE=TCPIP
Port=porta do appserver
[Drivers]
Active=TCP
[GENTCPIP]
Enable=0
Notas:
o Caso no existam no arquivo as sees devem ser includas.
o A porta informada na seo TCP deve ser informada tambm no arquivo smartclient.ini na seo.
[LICENSECLIENT]
server= servidor
port= porta
[HTTP]
ENABLE=1
PORT=86
PATH=\web\EAI
ENVIRONMENT= Informe o nome da seo referente a ENVIRONMENT
RESPONSEJOB=JOB_EAI_0101
[localhost:86]
ENABLE=1
PATH=\web\EAI
ENVIRONMENT= Informe o nome da seo referente a ENVIRONMENT
INSTANCENAME=EAI
RESPONSEJOB=JOB_EAI_0101
DEFAULTPAGE=wsindex.apw
Nota: Caso algum queira acessar de uma mquina externa, necessrio inserir tambm
uma seo como a de localhost acima (com as mesmas propriedades), com o IP da maquina
e uma com o Nome da mquina. Dessa forma possvel acessar de uma mquina externa
tanto pelo IP quanto pelo nome:
[IP da mquina:86]
[Nome da mquina:86]
[JOB_EAI_0101]
TYPE=WEBEX
ENVIRONMENT= Informe o nome da seo referente a ENVIRONMENT
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=EAI
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=01,01
Nota: caso o protheus tenha sido instalado desde o zero, ser necessrio realizar algumas configuraes antes de
acessar o mdulo SigaCFG:
Escolha a localizao.
Aps concluir estas configuraes, acesse no menu principal do mdulo SigaCFG: Ambiente | Cadastros |
Parmetros.
3.6 TOTVS Business Connect
Nota: Quando o IIS instalado aps o Visual necessrio rodar um comando para aplicar algumas configuraes
antes instalar o web service:
Aps executar o comando, rode o instalador TOTVS Business Connect para instalar o web service.
Antes de abrir o IIS, abra o Painel de Controle e acesse a parte referente a Programas e Recursos. Clique em Ativar
ou desativar recursos do Windows.
Verifique se todas as opes referentes a Servios de Informaes da Internet esto selecionadas. Caso no esteja,
selecione e salve as alteraes.
Abra o IIS.
Selecione Pools de Aplicativos e verifique se todos os servios esto iniciados.
Selecione: Sites | Default Web Site | TOTVBusinessConnect. Do lado direito selecione Configuraes Avanadas.
Em Pool de Aplicativos deve estar Classic .NET AppPool.
Nota: Tambm pode estar preenchido com ASP.NET v4.0 Classic ou TOTVSBusinessConnect
No diretrio do RM, os web services foram instalados na pasta WS_TBC. Ser necessrio realizar alguma
configuraes no arquivo web.config.
Altere as tags:
Para validar se as configuraes realizadas esto corretas abra o browser e informe no endereo: localhost ou IP da
mquina /TOTVSBusinessConnect/wsEAIService.asmx