Este documento irá abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja integração utilize Mensagem Única.

A

MBIENTE

L

INHA

RM

E

B

ACK

O

FFICE

P

ROTHEUS

Processo : Ambiente

Subprocesso Montagem de Ambiente com Linha RM e BackOffice Protheus. Data da publicação : 10/12/2012

Este documento irá abordar a montagem de um ambiente do BackOffice Protheus e da Linha RM cuja integração utilize Mensagem Única.

É um documento geral que não aborda a parte de configuração da integração em si. Após a montagem do ambiente, devem ser realizadas as configurações referentes a integração que se encontram na especificação da mesma.

Conteúdo

1. Pré Requisitos ... 2 1.1 Obtendo Arquivos ... 2 1.2 Atualizações Protheus ... 2 2. Instalação ... 4 2.1 Protheus ... 4 2.2 DBAcces ... 5 3. Configuração... 8 3.1 Protheus – Parte 1 ... 8 3.2 Configurando Banco SQL ... 10

3.3 Configurando Banco Oracle ... 14

3.4 Configurando Conexões 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

D

ESENVOLVIMENTO

/P

ROCEDIMENTO

1. Pré Requisitos

Para montar o ambiente é necessário instalar:  Protheus versão 11

 RM versão 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 validação referente à mensagem única caso a integração 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 opção TOTVS Application Server.

1.2 Atualizações Protheus

As versões mais recentes dos arquivos do Protheus podem ser encontradas nos seguintes caminhos:  Espelho do Portal: \\172.16.103.229\espelho-portal

É um diretório 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 conteúdo 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

Updates: Protheus11\2-update-BRA-CHI-EUA-PAR-URU\topconnect

Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho D-1.

Dicionários/Help Campos/Menus: Protheus11\Systemload

Nota: arquivo liberado para cliente. Para homologação o ideal é utilizar o do caminho

ATUSX.

DBAccess: Protheus11\TOTVS DBAccess  D-1: \\172.16.103.229\d-1

É um diretório onde são armazenadas as compilações diárias 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 - Versão do Protheus

 ATUSX: \\172.16.93.23\temp

É um diretório onde são disponibilizados diariamente as ultimas versões dos dicionários, 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 criação e manutenção de: Dicionários: • Índices (SIX) • Perguntas (SX1) • Arquivos (SX2) • Campos (SX3) • Tabelas genéricas (SX5) • Parâmetros (SX6) • Gatilhos (SX7) • Relacionamentos (SX9) • Pastas (SXA) • Consultas Padrão (SXB) • Grupo de campos (SXG) Arquivos “.CH” Menus do sistema Tabelas Padrão

2. Instalação

2.1 Protheus

Execute o instalador do Protheus e selecione a opção TOTVS | Application Server. A instalação é bem intuitiva.

Concluída a instalação, acesse o diretório 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 faça 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 também 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 instância do smartclient.

2.2 DBAcces

Após abra o local onde foi instalado o DBAcces.exe, e no caminho do diretório, insira no final –install.

O DBAcces será instalado como serviço.

Observação:

Outra maneira de configurar o DBAcces sem instalar como serviço é:

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.

Após basta iniciar o DBAcces:

Importante!! Quando o DBAcces é iniciado dessa forma, sempre que for fechar é necessário digitar CTRL + C,

e YES para confirmar. Após é necessário aguardar o aplicativo fechar sozinho. Este procedimento deve ser realizado para não dar inconsistências na base.

3. Configuração

3.1 Protheus – Parte 1

Para criar um ambiente com dois tipos de bancos, acesse o diretório 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 caminhoD-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, versão 110. A nomenclatura dos arquivos RPO está detalhada no início do documento, na parte de Atualizações Protheus.

Observação:

Caso esteja montando ambiente apenas para um tipo de banco, basta não criar as pastas ORACLE e MSSQL, e copiar o arquivo RPO direto para a pasta Protheus\apo

Copie os arquivos de dicionário para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\system. Selecione apenas os arquivos .xnu que são os arquivos de menu.

Os arquivos são encontrados em: \\172.16.93.23\temp

Selecione a pasta com a data desejada (neste exemplo, 20121128). Após, selecione: rel | txt | bra

Copie os outros dois arquivos - sx2.unq e sxsbra.txt - que são arquivos de dicionário, para a pasta: C:\TOTVS 11\Microsiga\Protheus_Data\systemload

Para um ambiente com os dois tipos de banco, faça uma cópia da pasta Protheus_Data e renomeie uma pasta para Protheus_oracle e a outra Protheus_mssql.

3.2 Configurando Banco SQL

São necessárias duas bases, uma para o RM e outra para o Protheus.

Para o RM, restaure e configure a base desejada normalmente. Para o Protheus não é necessário restaurar uma base. O Protheus cria as tabelas necessárias para o seu funcionamento de forma automática, sendo necessária apenas a configuração apontando para uma database vazia.

Para criar uma nova database no SQL Server conecte-se no mesmo, clique com o botão 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 é necessário criar um ODBC com o programa odbcad32. Abra o programa, selecione a aba “Fonte de Dados de Sistema”, e clique em “Adicionar”.

Obs* em máquinas 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 “Avançar”.

Selecione “Alterar o banco de dados padrão para”, escolha a base de dados protheus e clique em “Avançar”.

Caso deseje, altere o idioma. Após clique em “Concluir”.

Uma janela contendo o resumo da nova fonte de dados é exibida. Clique no botão “Testar fonte de dados...” para validar a conexão.

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, são necessárias duas instâncias, 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 usuário que será utilizado pelo Protheus. Utilize uma ferramenta para acessar a instância oracle criada para o RM. O comando que será executado deve ser rodado com o usuário sys ou system.

O comando para criar um novo usuário é: -- USER SQL

CREATE USER usuárioProtheus IDENTIFIED BY senhaProtheus DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP; -- ROLES

GRANT "RESOURCE" TO usuárioProtheus WITH ADMIN OPTION; GRANT "DBA" TO usuárioProtheus WITH ADMIN OPTION; GRANT "CONNECT" TO usuárioProtheus WITH ADMIN OPTION;

ALTER USER usuárioProtheus DEFAULT ROLE "RESOURCE","DBA","CONNECT"; -- QUOTAS

ALTER USER usuárioProtheus QUOTA UNLIMITED ON SYSTEM;

Nota: Altere usuárioProtheus para o nome do usuário que deseja criar, e senhaProtheus para a senha do usuário.

Após a criação do usuário do protheus devemos configurar uma nova nomeação de serviço na ferramenta Oracle Net Manager.

Selecione a pasta “Nomeação de Serviço” no Net Manager e clique em + para criar uma nova nomeação.

Selecione o protocolo TCP/IP e clique em “Próximo”.

Informe o nome do host e a porta (default 1521) e clique em “Próximo”.

Nota: O SID é o nome da instância RM do Oracle

Clique em “Testar” para validar se as configurações realizadas estão corretas.

Clique no botão “Alterar Login” e informe o nome do usuário e senha criados com o script anteriormente. Clique no botão “Ok”.

Após clique em “Testar”. Caso a configuração tenha sido executada corretamente o teste de conexão será bem sucedido.

Clique em “Fechar” para fechar a tela de testes e depois clique em “Finalizar” para concluir a instalação. Importante!

Antes de encerrar a aplicação selecione o menu Arquivo | Salvar Configuração de Rede para salvar a configuração realizada.

3.4 Configurando Conexões no DBAcces

Após a criação e configuração do database/schema temos que configurar as conexões no TOTVS DBAccess. Ele é a ferramenta utilizada pelo Protheus para fazer a comunicação entre o appserver e o SGBD.

Inicialize o DBAcces. Observação

Caso tenha sido configurado da outra forma, execute o DBAcces através do atalho.

Para configurarmos a conexão com o SQL Server utilizaremos a aba “Configurações” e depois a aba “Microsoft SQL”. Clique no botão “Novo”, e informe a base protheus referente ao banco SQL, nome do usuário e senha.

Para configurarmos a conexão Oracle utilizaremos a aba “Configurações” e depois a aba “Oracle”. Clique no botão “Novo” e informe a base protheus, o nome do usuário e a senha.

Importante!

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

Fazemos isto através do arquivo DBAccess.ini no diretório 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

Após finalizarmos a configuração das conexões podemos realizar o teste das mesmas através da aba “Assistentes”. Clique no botão “Validação de Conexão”.

Clique em “Avançar”. Selecione o SGBD e clique em “Avançar”. Informe o nome da conexão criada e clique em “Finalizar”.

Se a conexão 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 configuração do Protheus, iremos configurar o arquivo appserver.ini. Ele se encontra na pasta appserver, no diretório onde foi instalado o Protheus: C:\TOTVS 11\Microsiga\Protheus\bin\appserver

 Seção 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 conexão (TOP)

RPOLANGUAGE=linguagem do RPO (Portuguese) RPOVERSION=versão do RPO (110)

LOCALFILES=tipo dos arquivos locais (ADS)

LOCALDBEXTENSION=extensão das tabelas locais (.dbf) PICTFORMAT=DEFAULT

REGIONALLANGUAGE=localização (BRA) TOPSERVER=endereço 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 sessão DBAcces. Neste caso, retire as mesmas dessa sessão e transfira-as para a sessão Environment, inserindo TOP na frente. A sessão DBAcces deixa de existir.

o Altere o nome Environment por um nome que represente a conexão que está sendo criada.

o Caso esteja montando dois ambientes – Oracle e MSSQL – basta criar outra seção Environment, renomeando a mesma.

 Seção Geral

Deve possuir as propriedades: [GENERAL]

InstallPath=pasta do Protheus console=loga no console (0/1)

BuildKillUsers=desconecta todos os usuários quando compilar o RPO (0/1) LogEnable=habilitar arquivo de log (0/1)

ConsoleLog=loga no console (0/1)

consolemaxsize=tamanho máximo do log (10000000) ConsoleFile=arquivo de log

Segmento=cYdTm3WWERZF=1hu Serie===AV

Realizada as alterações, a seção ficará assim:

 Seção de Serviço

Deve possuir as propriedades: [SERVICE]

Name=Protheus11 DisplayName=Protheus 11

Nota: Caso não exista no arquivo deve ser incluída.

 Seções [TCP], [Drivers] e [GENTCPIP] Devem possuir as propriedades:

[TCP] TYPE=TCPIP Port=porta do appserver [Drivers] Active=TCP [GENTCPIP] Enable=0 Notas:

o Caso não existam no arquivo as seções devem ser incluídas.

o A porta informada na seção TCP deve ser informada também no arquivo smartclient.ini na seção. Realizada as alterações, as seções ficarão assim:

 Seção LICENSECLIENT

Deve possuir as propriedades: [LICENSECLIENT] server= servidor port= porta

Realizada as alterações, a seção ficará assim:

 Seção HTTP, localhost, JOB_EAI Deve possuir as propriedades:

[HTTP] ENABLE=1 PORT=86 PATH=\web\EAI

ENVIRONMENT= Informe o nome da seção referente a ENVIRONMENT RESPONSEJOB=JOB_EAI_0101

[localhost:86] ENABLE=1 PATH=\web\EAI

ENVIRONMENT= Informe o nome da seção referente a ENVIRONMENT INSTANCENAME=EAI

RESPONSEJOB=JOB_EAI_0101 DEFAULTPAGE=wsindex.apw

Nota: Caso alguém queira acessar de uma máquina externa, é necessário inserir também

uma seção como a de localhost acima (com as mesmas propriedades), com o IP da maquina e uma com o Nome da máquina. Dessa forma é possível acessar de uma máquina externa tanto pelo IP quanto pelo nome:

[IP da máquina:86] [Nome da máquina:86]

[JOB_EAI_0101] TYPE=WEBEX

ENVIRONMENT= Informe o nome da seção 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 integração. Esta configuração é feita no módulo SIGACFG do Protheus.

Inicie o appserver, e após o smartclient. Informe usuário e senha.

Nota: caso o protheus tenha sido instalado desde o zero, será necessário realizar algumas configurações antes de

acessar o módulo SigaCFG: Escolha a localização.

Informe o diretório dos arquivos de dados (selecione a pasta data).

Acesse: Ambiente | Schedule | Schedule. Após: Schedule | Agent | Cadastro

Clique em Incluir para cadastrar o JOB. Insira as informações solicitadas e salve o cadastro.

Após concluir estas configurações, acesse no menu principal do módulo SigaCFG: Ambiente | Cadastros | Parâmetros.

3.6 TOTVS Business Connect

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

Nota: Quando o IIS é instalado após o Visual é necessário rodar um comando para aplicar algumas configurações

antes instalar o web service:

Abra o prompt de comando e acesse o diretório: C:\Windows\Microsoft.NET\Framework\v4.0.30319 Após execute o comando aspnet_regiis -1.

Após 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 opções referentes a “Serviços de Informações da Internet” estão selecionadas. Caso não esteja, selecione e salve as alterações.

3.8 Internet Information Services (IIS)

Selecione “Pools de Aplicativos” e verifique se todos os serviços estão iniciados.

Em Pool de Aplicativos deve estar Classic .NET AppPool.

Nota: Também pode estar preenchido com ASP.NET v4.0 Classic ou TOTVSBusinessConnect

Apenas a “Autenticação Anônima” deve estar habilitada. Todas as outras devem estar desabilitadas.

Valide se a restrição do ASP.NET v4 está como Permitido. Caso não esteja altere para este status.

Nota: Os itens listados podem estar ou não com status permitido, mas é necessário que pelo menos o ASP.NET v4

3.9 Web.config

No diretório do RM, os web services foram instalados na pasta WS_TBC. Será necessário realizar alguma configurações no arquivo web.config.

Abra o arquivo e localize a tag appSettings.

Altere as tags:

Host = informe a máquina Port = porta do host

DBAlias = alias do banco de dados RM deve ser Obrigatóriamente CORPORERM, e deve obedecer letras maiúsculas e minúsculas (é case sensitive – deve ser verificado no Alias.dat e Web.config – devem estar obrigatóriamente iguais)

JobServer3Camadas = true (apenas se o acesso for de outra máquina) Após alterar o arquivo irá ficar assim:

Para validar se as configurações realizadas estão corretas abra o browser e informe no endereço: localhost ou IP da máquina /TOTVSBusinessConnect/wsEAIService.asmx

Será solicitado que informe usuário e senha para realizar a autenticação.