Instalação de um ambiente TOTVS | ESB

27/02/2012
 Instalação de um ambiente TOTVS | ESB

Sumário
Sumário ..........................................................................................................................................................2
1. Considerações Gerais ............................................................................................................................3
2. Pré-requisitos .......................................................................................................................................3
3. Instalação TDS + Plugin ESB ...................................................................................................................4
4. Diagramação do TOTVS | ESB ................................................................................................................10

2 Instalação de um ambiente TOTVS | ESB

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

1. Considerações Gerais
Com a liberação da versão 12 do TOTVS | ESB houve mudanças estruturais que introduz um novo con-
ceito nas metodologias para implantação e configuração nos servidores. O objetivo desse manual é
demonstrar como instalar e configurar um ambiente funcional utilizando o TDS (TOTVS | Developer
Studio) em conjunto com o TOTVS | ESB.
A primeira etapa para a montagem desse ambiente é a instalação do plugin TOTVS | ESB. O TDS é uma
ferramenta que possibilita realizar tarefas diferenciadas de administração e desenvolvimento com
auxílio de plugins específicos para cada finalidade. O plugin TOTVS | ESB é responsável pela configu-
ração e diagramação do servidor TOTVS | ESB.

2. Pré-requisitos
Um dos pré-requisitos é realizar o download e instalar o TDS. As instruções para realizar o download e
instalação do TDS se encontram no link http://ds.totvs.com/. Não é necessário a instalação de todos os
opcionais (plugins), apenas a instalação do plugin TOTVS | ESB que será descrito os procedimentos em
pormenores logo a seguir.
Outro pré-requisito é realizar o download e instalar o motor TOTVS | ESB. O download do motor TOTVS
| ESB é realizado através do portal do suporte (http://suporte.totvs.com). Após o login e acessar a pá-
gina de Download, deve-se selecionar as opções abaixo e clicar no botão Pesquisar:

Ocultar arquivos já baixados: Desmarcado

Linha: Tecnologia
Amb/Vers.: TOTVS ESB-12.00

Selecionar a mídia correspondente ao sistema operacional em que se deseja instalar e imediatamente

será redirecionado para baixar o arquivo desejado. Deve-se descompactar o arquivo e seguir as instru-
ções contidos na pasta docs/Configuracao de Ambiente/pt/Guia de Instalacao do
TOTVS ESB.pdf para a instalação do produto.

Instalação de um ambiente TOTVS | ESB 3

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

3. Instalação TDS + Plugin ESB

Com o TDS aberto, deve-se selecionar o item de menu Help → Install New Software... Na tela aberta,
clica-se no botão Add... e preencha os campos conforme abaixo. Dessa forma, permitirá que o TDS atu-
alize o plugin do ESB juntamente com as ou-
tras atualizações. Clica-se em OK para efeti-
var a operação.
A tela sofrerá uma atualização e na listagem
central aparecerá o plugin do TOTVS | ESB
com o resultado semelhante à imagem a se-
guir. Na listagem superior, o plugin TOTVS |
ESB deve ser selecionado bem como o item Contact all update sites during install to find required soft-
ware. Caso esse último não seja selecionado, o TDS não irá buscar outros pacotes necessários para o
devido funcionamento do plugin ESB. Ao clicar o botão Next é possível que haja uma lentidão para veri-
ficar e buscar os paco-
tes dependentes, de-
pendendo da conexão à
Internet.

4 Instalação de um ambiente TOTVS | ESB

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Após o término desse processo, apa-

recerá uma tela solicitando a confir-
mação da instalação do plugin TOTVS
| ESB, mencionando uma pequena
descrição e a versão a ser instalada no
TDS.

Após clicar em Next será exibido

um termo de licença que deverá ser a-
provado para prosseguir com a instala-
ção. Para iniciar os procedimentos de
instalação deve-se clicar em Finish.

Instalação de um ambiente TOTVS | ESB 5

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Imediatamente, o TDS realizará o download dos pacotes necessários para o funcionamento do plugin
TOTVS | ESB. Nessa etapa, é possível que haja uma lentidão no processo dependendo da conexão à
Internet. Durante o download um aviso é exibido com os dizeres abaixo. O aviso pode ser ignorado por
clicar no botão OK.
Warning: You are installing software that contains unsigned content. The au-
thenticity or validity of this software cannot be established. Do you want to
continue with the installation?

Finalizando a instalação do plugin, é solicitado para reiniciar o TDS. Esse procedimento é recomendado
para o bom funcionamento do produto. Com isso, o plugin TOTVS | ESB se encontra devidamente ins-
talado no TDS e pronto para configurar e realizar a diagramação do processador (motor) TOTVS | ESB.

Para que o plugin TOTVS | ESB se comunique com o motor TOTVS | ESB, é necessário que o último es-
teja executando. Para a primeira configuração deve-se acessar o diretório de instalação do motor
TOTVS | ESB e acessar a pasta bin. Executar os arquivos nessa ordem: startup-db.bat e startup-esb.bat.
Uma alternativa seria acessar o menu principal do sistema operacional e acessar os ícones Database
Startup e ESB Startup. Espere até que a mensagem Esb started!

6 Instalação de um ambiente TOTVS | ESB

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Voltando ao TDS, selecione o menu Window

→ Open Perspective → Other... Abrirá uma
caixa de diálogo, semelhante ao exibido ao
lado, com todas as perspectivas possíveis para
o TDS. Seleciona-se a opção TOTVS Servers e
clica-se em OK.

Instalação de um ambiente TOTVS | ESB 7

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

A área de trabalho do TDS sofrerá modificações se adequando à perspectiva selecionada. No painel

esquerdo denominado de Servers Extensions, será visualizado uma lista com um item raiz com a des-
crição Servers. Deverá clicar com o botão direito do mouse em cima do item raiz e selecionar o item de
menu TOTVS ESB → ESB Server.

Em seguida será aberto uma tela solicitando informações para conexão ao motor TOTVS | ESB. As in-
formações para se comunicar inicialmente com o motor TOTVS | ESB são:
Server Name: Identificador
do servidor para identifica-
ção por parte do usuário.
Host: Nome ou número IP do
motor TOTVS | ESB. Nesse
caso utilizaremos localhost.
Port: Porta de comunicação
com o motor TOTVS | ESB. O
padrão é 8085.

8 Instalação de um ambiente TOTVS | ESB

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Finalizando o cadastro, um novo item será mostrado no painel Servers Extension. Deve-se executar um
duplo clique em cima do item que foi cadastrado para que o TDS se comunique com o motor TOTVS |
ESB para capturando as informações necessárias. No painel central, abrirá uma tela com todas as con-
figurações do motor TOTVS | ESB que incluem banco de dados, servidor de licença, servidor HTTP, etc.
Após as configurações serem realizadas, deve-se clicar no botão “Save (Ctrl+S)”, situado no painel su-
perior, para enviar os dados para o motor TOTVS | ESB.

OBS.: As configurações aqui mencionadas não são imediatamente aplicadas. As-

sim, para que as configurações sejam aplicadas ao produto, deve-se reiniciar o
motor TOTVS | ESB.

Nesse momento é importante realizar as configurações na aba License Configuration, especialmente

em integrações que não envolvem produtos TOTVS (componentes TOTVS) e que fazem uso de outros
componentes como FileSender, MockReceiver, etc. Caso as integrações façam uso de componentes
TOTVS, essa configuração não é necessária. A tela abaixo mostra as configurações do motor TOTVS |
ESB.

Instalação de um ambiente TOTVS | ESB 9

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

4. Diagramação do TOTVS | ESB

Com a comunicação como motor TOTVS | ESB pronto, é
possível construir e publicar diagramas. Ainda no TDS,
selecione o menu Window → Open Perspective → O-
ther... deverá selecionar a perspectiva TOTVS | ESB e
clicar em OK. A área de trabalho irá ser atualizada e no
painel esquerdo para o ESB Navigator que conterá os
projetos com os diagramas do ESB.
Clicando com o botão direito no centro do ESB Naviga-
tor selecione o item de menu New → ESB Project. Ao
exibir a tela, preencha com todas as informações e após
clicar no botão Finish para criar um projeto.

No painel ESB Navigator aparecerá o projeto criado com uma estrutura de pastas padrão. Dentro des-
se projeto serão criados os diagramas para o TOTVS | ESB. Para criar um diagrama, clique com o botão
direito em cima do projeto e selecione o item New → ESB Diagram. Abrirá a tela abaixo solicitando o
nome do arquivo e, após digitar, clica-se no botão Finish para concluir a criação do arquivo de diagra-
ma.

10 Instalação de um ambiente TOTVS | ESB

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Na parte central da área de trabalho do

TDS, será aberto um editor próprio para
construir diagramas com os componen-
tes ESB situados no painel esquerdo do
editor. Assim, o mesmo é utilizado para
definir os receptores, transformadores e
enviadores de mensagens. As proprieda-
des de cada componente colocado no
diagrama serão exibidas no painel Pro-
perties situado na parte inferior do TDS.

Após a constituição do diagrama, deve-

se publicar o mesmo no motor TOTVS |
ESB. Para isso, deve-se clicar no meio
do diagrama com o botão direito e
acessar o menu Deploy to ESB Server...
conforme figura ao lado.

Instalação de um ambiente TOTVS | ESB 11

Versão 1.0
 Instalação de um ambiente TOTVS | ESB

Com isso aparecerá uma tela permitindo usuário selecionar o servidor TOTVS | ESB cadastrado anteri-
ormente. Ainda permite que o usuário opte por somente adicionar o diagrama atual aos diagramas
existentes no motor TOTVS | ESB ou se deseja substituir todos os diagramas existentes no motor
TOTVS | ESB pelo selecionado. Ao clicar no botão Finish, o processo de deploy será iniciado.

Com esses procedimentos, o

diagrama relacionado se encon-
tra disponível no motor TOTVS |
ESB, porém, não estará habilita-
do. O diagrama somente estará
funcional após o reinício do mo-
tor TOTVS | ESB.

12 Instalação de um ambiente TOTVS | ESB

Versão 1.0