AMBIENTE LINHA RM E BACKOFFICE PROTHEUS

Processo : Ambiente
Subprocesso Montagem de Ambiente com Linha RM e BackOffice Protheus.
Data da publicao : 10/12/2012






Este documento ir abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja
integrao utilize Mensagem nica.

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

Para montar o ambiente necessrio instalar:

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.


1.1 Obtendo Arquivos

Oracle: \\fileserver\Softwares\Livres\Banco de Dados\Oracle
MSSQL: \\fileserver\Softwares\Livres\Banco de Dados\SQL Server
RM: \\tecnologiabh\Instalar\CorporeRM\Versoes\11.8x
Protheus: http://www.totvs.com/suporte/central-de-download/seu-segmento/produto/microsiga
Nota: Selecionar a opo TOTVS Application Server.


1.2 Atualizaes Protheus

As verses mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:

Espelho do Portal: \\172.16.103.229\espelho-portal
um diretrio interno onde se encontram os arquivos disponibilizados no portal do cliente. Entre
eles podemos destacar as seguintes pastas:

AppServer/SmartClient: Protheus11\binario referencia 700120420
Nota: abrir o arquivo .rar e copiar o contedo da pasta AppServer para a pasta bin\appserver
do seu computador. Fazer o mesmo para a pasta SmartClient.

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.

Dicionrios/Help Campos/Menus: Protheus11\Systemload
Nota: arquivo liberado para cliente. Para homologao o ideal utilizar o do caminho
ATUSX.

DBAccess: Protheus11\TOTVS DBAccess

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.

A nomenclatura do RPO XX-X-X-000; onde:
tt - TOTVS;
a, c, d, t - ads, codebase, ctree, topconnect
e, p, s - english, portuguese, spanish
110 - Verso do Protheus


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)
Perguntas (SX1)
Arquivos (SX2)
Campos (SX3)
Tabelas genricas (SX5)
Parmetros (SX6)
Gatilhos (SX7)
Relacionamentos (SX9)
Pastas (SXA)
Consultas Padro (SXB)
Grupo de campos (SXG)
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.



O DBAcces ser instalado como servio.



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

3.1 Protheus Parte 1

Para criar um ambiente com dois tipos de bancos, acesse o diretrio do Protheus, pasta apo: C:\TOTVS
11\Microsiga\Protheus\apo

Crie duas pastas: MSSQL e ORACLE.



Copie o arquivo RPO para dentro de cada uma das pastas.
O arquivo obtido no caminho D-1: \\172.16.103.229\d-1 pasta P11. Selecione o arquivo tttp110.

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


Copie os arquivos de dicionrio para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\system. Selecione apenas os
arquivos .xnu que so os arquivos de menu.

Os arquivos so encontrados em: \\172.16.93.23\temp
Selecione a pasta com a data desejada (neste exemplo, 20121128). Aps, selecione: rel | txt | bra
Nota: Sendo que 20122128 a data (AAAAMMDD). Selecione a pasta com a data mais atual.



Copie os outros dois arquivos - sx2.unq e sxsbra.txt - que so arquivos de dicionrio, para a pasta: C:\TOTVS
11\Microsiga\Protheus_Data\systemload



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.


3.2 Configurando Banco SQL

So necessrias duas bases, uma para o RM e outra para o Protheus.

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





Selecione a fonte de dados SQL Server e clique em Concluir.



Informe o nome da base de dados protheus criada anteriormente e o servidor. Clique em Avanar.



Clique em Avanar.



Selecione Alterar o banco de dados padro para, escolha a base de dados protheus e clique em Avanar.


Caso deseje, altere o idioma. Aps clique em Concluir.



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:




3.3 Configurando Banco Oracle

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.

No exemplo abaixo foi utilizado a ferramenta SqlDbx.









O comando para criar um novo usurio :

-- 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.



Informe um nome para o servio de rede e clique em Prximo.



Selecione o protocolo TCP/IP e clique em Prximo.



Informe o nome do host e a porta (default 1521) e clique em Prximo.



Informe o nome do SID informado na instalao do Oracle. Clique em Prximo.
Nota: O SID o nome da instncia RM do Oracle



Clique em Testar para validar se as configuraes realizadas esto corretas.


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.







3.4 Configurando Conexes no DBAcces

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.




Aps iniciar o DBAcces, inicie o DBMonitor.





Para configurarmos a conexo com o SQL Server utilizaremos a aba Configuraes e depois a aba Microsoft SQL.
Clique no boto Novo, e informe a base protheus referente ao banco SQL, nome do usurio e senha.



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.

Marque o checkbox Usar BLOB para campo MEMO.




Importante!
O DBAccess precisa que o caminho para a biblioteca do Oracle seja informada para o seu correto
funcionamento.

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.



Realize o mesmo teste para a base oracle.



3.5 Protheus Parte 2

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

Deve possuir as propriedades:

[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.

Realizada as alteraes, a seo ficar assim:



Seo Geral

Deve possuir as propriedades:

[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

Realizada as alteraes, a seo ficar assim:



Seo de Servio

Deve possuir as propriedades:

[SERVICE]
Name=Protheus11
DisplayName=Protheus 11

Nota: Caso no exista no arquivo deve ser includa.

Realizada as alteraes, a seo ficar assim:




Sees [TCP], [Drivers] e [GENTCPIP]

Devem possuir as propriedades:

[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.

Realizada as alteraes, as sees ficaro assim:



Seo LICENSECLIENT

Deve possuir as propriedades:

[LICENSECLIENT]
server= servidor
port= porta

Realizada as alteraes, a seo ficar assim:




Seo HTTP, localhost, JOB_EAI

Deve possuir as propriedades:

[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

Realizada as alteraes, a seo ficar assim:




Para configurar o EAI precisamos cadastrar o job que ir monitorar a fila de integrao. Esta configurao feita no
mdulo SIGACFG do Protheus.

Inicie o appserver, e aps o smartclient. Informe usurio e senha.

Nota: caso o protheus tenha sido instalado desde o zero, ser necessrio realizar algumas configuraes antes de
acessar o mdulo SigaCFG:

Escolha a localizao.



Informe o diretrio dos arquivos de dados (selecione a pasta data).



Informe o valor das Moedas




Acesse: Ambiente | Schedule | Schedule. Aps: Schedule | Agent | Cadastro
Clique em Incluir para cadastrar o JOB. Insira as informaes solicitadas e salve o cadastro.



Aps concluir estas configuraes, acesse no menu principal do mdulo SigaCFG: Ambiente | Cadastros |
Parmetros.






3.6 TOTVS Business Connect


Para instalar os web services execute o instalador do TOTVS Business Connect.
O aplicativo esta disponvel em: \\tecnologiabh\Instalar\CorporeRM\Versoes



Nota: Quando o IIS instalado aps o Visual necessrio rodar um comando para aplicar algumas configuraes
antes instalar o web service:

Abra o prompt de comando e acesse o diretrio: C:\Windows\Microsoft.NET\Framework\v4.0.30319
Aps execute o comando aspnet_regiis -1.

Aps executar o comando, rode o instalador TOTVS Business Connect para instalar o web service.


3.7 Painel de Controle

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.



3.8 Internet Information Services (IIS)


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



Aps realizar a configurao do Pool de Aplicativos selecione TOTVBusinessConnect e clique em Autenticao.



Apenas a Autenticao Annima deve estar habilitada. Todas as outras devem estar desabilitadas.



Em seguida, selecione o servidor e clique em Restries ISAPI e CGI.



Valide se a restrio do ASP.NET v4 est como Permitido. Caso no esteja altere para este status.
Nota: Os itens listados podem estar ou no com status permitido, mas necessrio que pelo menos o ASP.NET v4
esteja com este status.





3.9 Web.config

No diretrio do RM, os web services foram instalados na pasta WS_TBC. Ser necessrio realizar alguma
configuraes no arquivo web.config.



Abra o arquivo e localize a tag appSettings.



Altere as tags:

Host = informe a mquina
Port = porta do host
DBAlias = alias do banco de dados RM deve ser Obrigatriamente CORPORERM, e deve obedecer letras
maisculas e minsculas ( case sensitive deve ser verificado no Alias.dat e Web.config devem estar
obrigatriamente iguais)
JobServer3Camadas = true (apenas se o acesso for de outra mquina)

Aps alterar o arquivo ir ficar assim:




Para validar se as configuraes realizadas esto corretas abra o browser e informe no endereo: localhost ou IP da
mquina /TOTVSBusinessConnect/wsEAIService.asmx

Ser solicitado que informe usurio e senha para realizar a autenticao.
Nota: O usurio e senha so da base de dados que foi configurada no arquivo web.config.



Aps informar os dados e realizar o login, a pgina do web.service ser apresentada.