Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Processo
Subprocesso
Ambiente
Montagem de Ambiente com Linha RM e BackOffice Protheus.
Data da publicao
10/12/2012
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.
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.
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.
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.
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 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.
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
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.
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:
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.
Caso tenha sido configurado da outra forma, execute o DBAcces atravs do atalho.
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.
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
Seo de Servio
Deve possuir as propriedades:
[SERVICE]
Name=Protheus11
DisplayName=Protheus 11
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
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
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.
Aps concluir estas configuraes, acesse no menu principal do mdulo SigaCFG: Ambiente | Cadastros |
Parmetros.
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.
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: Sites | Default Web Site | TOTVBusinessConnect. Do lado direito selecione Configuraes Avanadas.
Apenas a Autenticao Annima deve estar habilitada. Todas as outras devem estar desabilitadas.
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.
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.