Manual de Instalação

MIS-006-0

Componentes de Integração
RODOCRED VALE-PEDÁGIO

Termo de Confidencialidade
O leitor é notificado que este documento e seu conteúdo estão sujeito à confidencialidade, não podendo seu conteúdo,
total ou parcial, ser copiado, transcrito ou replicado sem a formal permissão por escrito da Dbtrans S/A.
 Documento: Página:
Manual de Instalação 2 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

Ver Data Autor Revisor Aprovador Motivo da Revisão / Conteúdo Revisado

Anderson Eduardo Márcio
0.1 19/06/2012 Criação do documento.
Rodrigues Dias Athayde
Anderson Eduardo Márcio Informações adicionais para instalação sobre Windows
0.2 10/01/2013 2008 Server
Rodrigues Dias Athayde
Anderson Eduardo Márcio Informações adicionais para instalação com verificação de
0.3 30/10/2013 reutilização do cupom na mesma pista
Rodrigues Dias Athayde
 Documento: Página:
Manual de Instalação 3 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

SUMÁRIO
1 INTRODUÇÃO ..................................................................................................................... 4
1.1 Políticas ............................................................................................................................................ 4
1.2 Documentos complementares .......................................................................................................... 4
2 TERMINOLOGIA UTILIZADA .............................................................................................. 5

3 RECURSOS NECESSÁRIOS .............................................................................................. 6

3.1 Recursos humanos ........................................................................................................................... 6
3.2 Recursos materiais ........................................................................................................................... 6
3.2.1 Hardware: ................................................................................................................................6
3.2.2 Software: ..................................................................................................................................6
3.2.2.1 Plataforma Linux: ..............................................................................................................6
3.2.2.2 Plataformas Windows: ......................................................................................................6
4 INSTALAÇÃO DOS COMPONENTES ................................................................................. 7
4.1 Instalação sobre plataforma Linux .................................................................................................... 7
4.2 Instalação sobre plataformas Windows de 32 bits ........................................................................... 7
4.3 Instalação sobre plataformas Windows de 64 bits ........................................................................... 7
 Documento: Página:
Manual de Instalação 4 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

1 INTRODUÇÃO
Este documento tem como objetivo apresentar o roteiro das ações necessárias para a instalação dos
componentes de integração com o e-Pedágio nas concessionárias de rodovias.

A passagem para a forma integrada de processamento de cupons Rodocred Vale-pedágio segue as

seguintes etapas:

1. A Dbtrans entrega à Concessionária, e esta disponibiliza ao seu fornecedor de software, as

bibliotecas de integração da Dbtrans que serão incorporadas ao seu produto;

2. A Dbtrans fornece à Concessionária os dados que devem alimentar o software da

Concessionária para a correta comunicação com a Dbtrans: chaves, códigos, etc.;

3. A Dbtrans atribui status da Concessionária como “integrada” no ambiente de homologação;

4. A Concessionária, assistida por seu fornecedor de software, configura seu sistema com os dados
recebidos da Dbtrans no passo 2, realizando treinamento do processo;

5. A Concessionária, assistida por seu fornecedor de software, executa alguns testes, enviando lotes
de cupons para o ambiente de homologação da Dbtrans;

6. A Dbtrans após verificar o correto funcionamento em todas as etapas validando os testes de

homologação, atribui status da Concessionária como “integrada” no ambiente de produção e,

7. A Concessionária passa a enviar todos os lotes de cupons para o ambiente de produção da

Dbtrans estando totalmente em operação

Nota: Esta versão inclui funcionalidade adicional para verificação de reutilização do cupom na mesma pista.

1.1 Políticas
Toda atividade técnica realizada em equipamentos deverá ser orientada através de um manual
(montagem, instalação, operação ou teste) que descreve as ações a serem executadas em cada caso
previsto;

1.2 Documentos complementares

As funcionalidades oferecidas pelos componentes de integração com o Rodocred Vale-Pedágio estão
descritas no documento “Projeto Integração DBTRANS Rodocred E-Pedágio - Operadoras
Rodovias”, parte integrante do pacote fornecido à Concessionária.
 Documento: Página:
Manual de Instalação 5 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

2 TERMINOLOGIA UTILIZADA
A seguir são relacionados os termos técnicos usados neste documento e seu significado:

Termo Significado
Biblioteca Dispositivo de software reutilizável que oferece funcionalidades que podem ser utilizadas por
Compartilhada vários programas.
Componente Biblioteca Compartilhada que pode ser usada de forma independente da linguagem de
ActiveX programação na qual foi escrita.
Conjunto de transações de pedágio, agrupadas por data e por praça, que devem ser enviadas ao
Movimentação
Rodocred Vale-Pedágio para processamento.
Processo que torna conhecida a localização de uma DLL, possibilitando que outros programas
Registro de DLL
usem as funcionalidades por ela oferecidas.
Tradução de Conversão dos códigos criptografados dos cupons de vale-pedágio em dados inteligíveis: valor,
Cupons validade, praça, etc.
Troca de dados, seja envio (upload) ou recebimento (download), com o Sistema Rodocred Vale-
Transferência
Pedágio.
 Documento: Página:
Manual de Instalação 6 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

3 RECURSOS NECESSÁRIOS
Para realizar este procedimento como descrito neste manual são necessários os seguintes recursos:

3.1 Recursos humanos

Colaborador com perfil técnico, familiarizado com o sistema operacional sobre o qual os componentes
serão instalados.

3.2 Recursos materiais

3.2.1 Hardware:

 Computador no qual os componentes serão instalados.

3.2.2 Software:

3.2.2.1 Plataforma Linux:

Sobre plataforma Linux, a solução é oferecida na forma de uma biblioteca compartilhada, gerada
especificamente para a distribuição adotada pela concessionária.

Tradução de Cupons:
 usr/include/dbt25001.h
 usr/lib/dbt25001.so
 usr/doc/dbtrans/dbtrans.cpp
 usr/bin/dbtrans
código fonte, cabeçalho da função
biblioteca compartilhada
código fonte, programa de exemplo
binário do programa de exemplo

3.2.2.2 Plataformas Windows:

Sobre plataformas Windows (Win32 e Win64), a solução é oferecida na forma de um conjunto de
componentes ActiveX.

Tradução de Cupons:
 dbt25001.dll

Movimentação e Transferência:
 dbt25002.dll
 simplezip.dll
 site.dll
 unzdll.dll
 wwwdialup.dll
 wwwxml.dll
 zip32.dll
 zipdll.dll
 Documento: Página:
Manual de Instalação 7 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

4 INSTALAÇÃO DOS COMPONENTES

4.1 Instalação sobre plataforma Linux
A tradução de cupons é feita através de chamada à função “Valida”, cujo cabeçalho está no arquivo
dbt25001.h:

#ifndef _DBT25001_H_
#define _DBT25001_H_

typedef enum codErro { errLen14=1, errCod14, errDescrip, errCod32 };

long Valida(char *strCod32, char *strCod14, long lngPraId,

double *dblValor,
char *strValidade,
long *lngClasseVeiculo,
long *lngCodErro,
char *strMsgErro);

#endif

Para que a função esteja disponível, a biblioteca compartilhada dbt25001.so deve ser referenciada
em tempo de compilação.

4.2 Instalação sobre plataformas Windows de 32 bits

1. Copiar os arquivos para a pasta c:\windows\system32

2. Registrar as DLLs que exportam componentes ActiveX

a. regsvr32 c:\windows\system32\dbt25001.dll
b. regsvr32 c:\windows\system32\dbt25002.dll
c. regsvr32 c:\windows\system32\site.dll
d. regsvr32 c:\windows\system32\wwwxml.dll

3. Dar permissão de leitura e escrita aos arquivos que guardam os registros de uso de cupons

a. c:\windows\system32\dbt25001.$$1
b. c:\windows\system32\dbt25001.$$2

4.3 Instalação sobre plataformas Windows de 64 bits

1. Copiar os arquivos para a pasta c:\windows\syswow64

2. Registrar as DLLs que exportam componentes ActiveX

a. regsvr32 c:\windows\syswow64\dbt25001.dll
b. regsvr32 c:\windows\syswow64\dbt25002.dll
c. regsvr32 c:\windows\syswow64\site.dll
d. regsvr32 c:\windows\syswow64\wwwxml.dll
 Documento: Página:
Manual de Instalação 8 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

3. Dar permissão de leitura e escrita aos arquivos que guardam os registros de uso de cupons. O
usuário configurado no Aplicativo Servidor (item 4) precisará ter permissões de leitura e escrita
nestes arquivos.

a. c:\windows\syswow64\dbt25001.$$1
b. c:\windows\syswow64\dbt25001.$$2

4. Criar no Serviço de Componentes do Windows um Aplicativo Servidor que execute com credenciais
que tenham acesso aos recursos necessários: internet, pastas da rede no caso do uso de
compartilhamentos, bem como permissões de leitura e escrita nos arquivos listados no item 3.

a. Iniciar > Todos os Programas > Ferramentas Administrativas > Serviços de Componentes
ou
Iniciar > Painel de Controle > Ferramentas Administrativas > Serviços de Componentes

b. Navegar até Computadores > Meu Computador > Aplicativos COM+

c. Botão direito > Novo > Aplicativo

d. Selecionar “Criar um aplicativo vazio”

 Documento: Página:
Manual de Instalação 9 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

e. Selecionar “Aplicativo de servidor”, nomear o aplicativo “DBTRANS”

f. Selecionar “Serviço Local – Conta de serviço interna” (*), avançar até concluir.
 Documento: Página:
Manual de Instalação 10 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

(*) Observação: sobre Windows 2008 Server será necessário configurar o usuário para
“Usuário interativo” se os componentes forem instanciados a partir de uma aplicação desktop,
ou para “Este usuário”, configurando um usuário específico, se os componentes forem
instanciados a partir de um serviço do windows ou de uma tarefa agendada. Em ambos os
casos o usuário configurado deverá ter os privilégios necessários para acessar a internet e
acessar os arquivos e pastas configurados. Por exemplo, se os arquivos a serem
criptografados estiverem na pasta C:\ORIGEM e o caminho de destino for C:\DESTINO, o
usuário deverá ter permissão de leitura para os arquivos da pasta C:\ORIGEM e permissão de
escrita na pasta C:\DESTINO. Já se os arquivos estiverem em uma pasta da rede, o usuário
configurado no aplicativo deverá ter permissões de acesso a esta pasta.

g. Sobre os Componentes do aplicativo DBTRANS, botão direito > Novo > Componente
Documento: Página:
Manual de Instalação 11 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013
 Documento: Página:
Manual de Instalação 12 de 12
Código: Público: Versão:
MIS-006-0 Irrestrito 0.1
Objeto: Emissão:
Componentes Integração Rodocred Vale-Pedágio 30/10/2013

h. Selecionar “Importar componente(s) já registrados”

i. Marcar “Registro de 32 bits”, selecionar na lista os componentes

IntegracaoDbtrans.Arquivo e IntegracaoDbtrans.Cupom.1

j. Avançar até concluir.

Final do documento MIS-006-0 Componentes Integração Rodocred VP