You are on page 1of 40

AMBIENTE LINHA RM E BACKOFFICE PROTHEUS

Processo

Subprocesso

Ambiente
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)
Arquivos .CH
Menus do sistema
Tabelas Padro
Help de campos e mensagens

Gatilhos (SX7)
Relacionamentos (SX9)
Pastas (SXA)
Consultas Padro (SXB)
Grupo de campos (SXG)

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.

You might also like