Professional Documents
Culture Documents
Documento:
Classificao:
Autor:
Depositrio:
Histrico
Verso
1.0.0
Data
27/07/12
Autor
Comentrios
Primeira verso deste documento
30/7/2012 11:31
Confidencial Auttar
Pg.: 2/30
ndice
1.
2.
3.
Introduo _______________________________________________________________ 4
Convenes utilizadas neste Manual __________________________________________ 5
Pr-requisitos ____________________________________________________________ 6
Concentrador CTF ___________________________________________________________ 6
Servidor Banco de Dados ______________________________________________________ 6
Conexo X.25 _______________________________________________________________ 6
4. Instalao do CTF _________________________________________________________ 7
Instalando o concentrador CTF _________________________________________________ 7
5. Configurando o CTF _______________________________________________________ 10
Configurando o CTF como Servio ____________________________________________ 10
Portas do CTF ______________________________________________________________ 15
Conexo com o Banco de Dados _______________________________________________ 17
6. Cadastro do CTF _________________________________________________________ 19
Cadastro via MENPRI ________________________________________________________ 19
Cadastro de Estabelecimento e Loja ____________________________________________ 20
Cadastro de VANS __________________________________________________________ 21
Cadastro X.25/VANS e parmetros de comunicao _______________________________ 23
Cadastro de Autorizadoras ___________________________________________________ 24
Inicializando o CTF __________________________________________________________ 29
Observaes Gerais ___________________________________________________________ 30
30/7/2012 11:31
Confidencial Auttar
Pg.: 3/30
1. Introduo
O CTF, Concentrador de Transaes Financeiras, controla o fluxo de mensagens entre um cliente CTF
e as autorizadoras, gerenciando o trfego de vrias transaes simultneas e permitindo que a
autorizao do pagamento de compras com cartes de crdito / dbito e consulta de cheques, seja
realizado de maneira ON-LINE.
O CTF trabalha como servio atravs do CTFControl.exe, e a janela de trace do CTF no mais ser
exibida nem ser mais necessrio se logar no servidor para ativar o CTF.
Internamente o CTF passou a ser dividido em mdulos. Cada VAN passa a ser 1 mdulo no CTF, assim
como o mdulo ICC (Interface de comunicao com o Cliente) que fica responsvel pelo recebimento,
tratamento e roteamento da transao para um dos mdulos.
O CTFControl no Windows dever funcionar como servio, sendo responsvel pela ativao dos mdulos
do CTF, monitorao (se algum dos mdulos sair do ar ele coloca no ar novamente depois de algum
tempo), desativao dos mdulos do CTF, e pelo processo de corte do CTF (o CTFControl pode fazer
ou no corte, isso um parmetro).
O objetivo deste documento de auxiliar no processo de instalao e configurao do CTF atravs das
orientaes a seguir.
30/7/2012 11:31
Confidencial Auttar
Pg.: 4/30
ATENO !
Fornece informaes que podem no ser notadas com facilidade, e que so
importantes.
DICA
Fornece informaes para economizar tempo na operao a ser realizada.
AGUARDE
O usurio dever aguardar trmino da operao que est sendo executada.
CUIDADO
Advertir o usurio sobre problemas que podem ocorrer.
30/7/2012 11:31
Confidencial Auttar
Pg.: 5/30
3. Pr-requisitos
A configurao mnima para instalao e funcionamento do concentrador CTF:
Concentrador CTF
Conexo X.25
30/7/2012 11:31
Confidencial Auttar
Pg.: 6/30
4. Instalao do CTF
Instalando o concentrador CTF
A partir do CD de instalao, execute o arquivo Setup.exe (arquivo contido no diretrio CTF)
responsvel pela instalao do software. Na tela a seguir Aparecer o assistente de instalao, aguarde
at que a mesma seja carregada completamente conforme a (Erro! Fonte de referncia no
encontrada.) abaixo representada.
(Figura 1)
A prxima tela a ser exibida ser de Boas Vindas do assistente de instalao do CTF. Clique no boto
Avanar >, como mostra a (Erro! Fonte de referncia no encontrada.) abaixo.
Importante que essa atividade seja realizado junto a um analista de implantao da AUTTAR,
visando garantia de todo o processo de migrao.
30/7/2012 11:31
Confidencial Auttar
Pg.: 7/30
O assistente de instalao ir exibir a tela que indica a pasta onde dever ser instalado o CTF, esta tela
j vem com a pasta default indicada na(Erro! Fonte de referncia no encontrada.). Recomendamos a
instalao do CTF nessa pasta.
A(
) ser exibida para seleo de uma pasta de programas, selecione a pasta desejada e clique em Avanar
>.(Figura 3)
(Figura 4)
30/7/2012 11:31
Confidencial Auttar
Pg.: 8/30
O processo de instalao ser iniciado nesse momento. A tela abaixo mostra o quanto j foi instalado
(Erro! Fonte de referncia no encontrada.).
(Figura 5)
Aps este processo a instalao do CTF estar concluda. Ser exibida a tela a seguir, clique em . OK .
para finalizar a instalao (Erro! Fonte de referncia no encontrada.).
(Figura 6)
30/7/2012 11:31
Confidencial Auttar
Pg.: 9/30
5. Configurando o CTF
Configurando o CTF
como Servio
Aps a instalao do ambiente na maquina definida para a instncia de CTF ser necessrio efetuar
as configuraes para que o mesmo funcione como servio.
Descrevemos a seguir a opo de instalao automtica do Servio CTFCONTROL;
Execute no prompt do DOS o comando abaixo:
[drive]:\ctf_auttar\bin\instctfcontrol [drive]:
Onde tem [drive]: o local onde foi instalado o diretrio default do CTF.
O exemplo abaixo mostra a instalao do servio CTFCONTROL com aplicao instalada no drive D: do
concentrador do CTF.
(Figura 7)
Para efetuar a configurao manual, faremos uso de um utilitrio disponibilizado pela Microsoft, para
esta finalidade. Trata-se do INSTSRV.EXE que o responsvel pela criao (cadastramento) de um
servio no ambiente Windows.
Este utilitrio poder ser encontrado no Resource Kit do Windows 2000 ou no site da Microsoft. Ele
tambm ser disponibilizado na instalao do CTF no diretrio \CTF_AUTTAR\BIN.
Considerando que o utilitrio INSTSRV.EXE est no diretrio C:\CTF_CSI\BIN, execute, na linha de
comando do DOS:
INSTSRV CTFControl C:\CTF_AUTTAR\BIN\CTFControl.EXE
30/7/2012 11:31
Confidencial Auttar
Pg.: 10/30
O primeiro parmetro ser o nome do servio a ser criado (deve ser igual ao nome do
executvel).
O segundo parmetro, neste caso, o caminho completo onde o executvel esta disponvel.
ATENO !
O CTFControl no Windows dever funcionar como servio, sendo responsvel pela ativao dos
mdulos do CTF, monitorao (se algum dos mdulos sair do ar ele coloca no ar novamente logo
em seguida), o CTFControl tambm responsvel pelo processo de corte do CTF finalizando os
mdulos e chamando a rotina de compactao/limpeza dos logs/traces da aplicao.
30/7/2012 11:31
Confidencial Auttar
Pg.: 11/30
A forma de consultar se o servio foi realmente instalado, acessar o Gerenciador de Servios e verificar
se o mesmo foi instalado Automaticamente.
Localize o servio CTFControl no seu Gerenciado de Servios. (Figura 8):
Servio do CTF
(Figura 8)
30/7/2012 11:31
Confidencial Auttar
Pg.: 12/30
Clique duas vezes sobre o servio CTFControl e ser exibida a tela a seguir. (Figura 9):
Nome do Servio
Tipo de
Inicializao
(Figura 9)
30/7/2012 11:31
Confidencial Auttar
Pg.: 13/30
Marque aqui.
Usurio
administrador
Senha do usurio
administrador
(Figura 10)
Aps os passos acima, deixamos o CTF pronto para ser inicializado. No ative o servio CTFCONTROL at que todas
as configuraes estejam definidas, caso seja necessrio reiniciar a maquina por algum motivo, sugerimos colocar
o servio CTFCONTROL para o tipo de inicializao MANUAL.
30/7/2012 11:31
Confidencial Auttar
Pg.: 14/30
Portas do CTF
Informaes de configurao caso haja necessidade de habilitar as portas usadas pelo CTF no
Firewall da maquina/rede.
Componente
Porta
Atual
Tipo
Origem
Destino
Interface de
Comunicao Client (ICC
Interface de
Comunicao Client (ICC)
Interface de
Comunicao Client (ICC)
Interface de
Comunicao Client (ICC)
CTF Control
1998
Servidor Conector
CTF Control
8101
Interno/
Externo
Interno/
Externo
Interno/
Externo
Interno/
Externo
Interno/
Externo
Interno/
Externo
Interno
Servidor CTF
(CTFICC)
Servidor CTF
(CTFICC)
Servidor CTF
(CTFICC)
Servidor Visualizer
(Monitor)
Servidor CTF
(CTFICC)
Servidor Visualizer
(Monitor)
Servidor CTF
(Vans)
Servidor CTF (Vans)
Servidor CTF (Vans)
Servidor CTF
(Vans remota/outra
instncia/sites)
Servidor Visualizer
(Monitor)
Roteador
5002
5003
8100
5001
Comunicao ICC
com as VANS
Comunicao de controle
com as VANS
6001 6099
6301 - 6399
6101 - 6199
Comunicao VANS
com as Visualizer
Comunicao VANS
com as Autorizadoras
Comunicao entre
Componentes do CTF
com servidor de Banco de
Dados
8000 - 8099
Comunicao de controle
com as VANS
32769 - 32832
2500 4500
6101 - 6199
Interno/
Externo
Servidor CTF
Servidor GUI
Servidor CTF
(CTFICC)
Servidor GUI
Servidor CTF
(CTFControl)
Servidor CTF
(CTFICC)
CTFControl
Servidor GUI
Servidor CTF
(Vans local)
Interno/
Externo
Interno/
Externo
Interno/
Externo
Servidor CTF
(CTFICC)
Servidor CTF
(Vans)
Servidor CTF
(ICC, Vans)
Interno/
Externo
CTFControl
Servidor GUI
Servidor CTF
(Vans local)
Servidor Banco
de Dados
Descrio
Conexo Lojas via Conector (TCP)
Servio de troca de mensagens de
controle
Servio de Excluso
Porta de comunicao com
Visualizer
Servio de troca de mensagens de
controle (Sinalizar finalizao)
Porta de comunicao com
Visualizer
Intervalo de comunicao
Estas portas so utilizadas pela GUI
e CTFControl que conectam com as
Vans para envio de mensagens de
controle
(monitorao
e
eliminao de pendncias)
Intervalo de comunicao para
envio de mensagens
Intervalo de comunicao portas
do Roteador
Intervalo de comunicao utilizado
pelos componentes do CTF para
estabelecer comunicao via ADO
(conexes dinmicas) com o
servidor de banco de dados.
Estas portas so utilizadas pela GUI
e CTFControl que conectam com as
Vans para envio de mensagens de
controle
(monitorao
e
eliminao de pendncias)
Para evitar conflito das portas de uso interno da aplicao do CTF e portas acessada dinamicamente
pelo ADO, precisa ser executado o script (TEF_ReservedPorts.reg) para realizar a proteo de portas
da aplicao. Assim, a execuo deste script vai permitir a proteo pelo Sistema Operacional para que
o intervalo de portas 1996 e 2499 no estejam disponveis para acesso dinmico TCP/IP.
30/7/2012 11:31
Confidencial Auttar
Pg.: 15/30
30/7/2012 11:31
Confidencial Auttar
Pg.: 16/30
Selecione o Outro:
Procure a pasta
dos arquivos de
configurao
do CTF
Arquivo de conexo
com o Banco
Nome do
Arquivo:
Selecione
Operao
IP ou NOME
Identificao
do Produto:
Diretrio de
Pesquisa
Outro:
Nome do
Banco do CTF
Banco de
Dados
Conexo:
Banco de
Dados
Servidor:
Banco:
Quantidade
de Conexes
com o banco
Nome do
arquivo de
Template do
CTF, conforme o
o tipo do banco
de dados
Usurio:
Senha:
Quant.
Conexes:
Template:
CTF
Deve ser selecionado o
Diretrio da pasta DAD
do diretrio default do
CTF informado o
endereo
[drive]:\ctf_csi\dad
PARAMBD.DAT (no
esquea da observao
acima em ATENO
<Operao>
: Selecione o Banco de
dados (SQL Server)
Nome do novo
Servidor de banco de
dados SQL Sever 2008.
Deve-se informar o
nome da nova Base de
Dados.
Usurio de Conexo
com o banco.
Senha do usurio de
conexo com o banco.
Quantidade de
conexes com o banco
Devemos usar o
template STRSQL.DAT
para bancos SQLServer
e STRSQL.DAT.ORALCE
para bancos Oracle.
(Figura 14)
ATENO !
O Arquivo PARAMBD.dat tambm deve estar configura por VAN, ou seja, devemos criar os
arquivos PARAMBDs por cdigo da VAN, como pro exemplo;
PARAMBD69.DAT,
PARAMBD90.dat e etc, fazendo isso garantimos individualmente a quantidade de conexes com
o banco por VAN configurada.
30/7/2012 11:31
Confidencial Auttar
Pg.: 17/30
Teste de Conexo
com o Banco
(Figura 15)
ATENO !
Antes de clicar no boto salvar os dados digitados na tela acima, realize o teste de conexo
com o banco para validar se a conexo foi estabelecida.
Realize o teste de conexo com o banco de dados para cada arquivo PARAMBD existente,
fazendo isso vamos garantir a comunicao do CTF com o banco. (realizar este
procedimento em todas as instncias de CTF)
O CTF utiliza o componente ADO (Microsoft ActiveX Data) como interface para acesso ao
servidor de banco de dados. Para cada conexo de banco de dados inicializada no servidor
de banco de dados, o ADO abre dinamicamente uma porta socket (comunicao entre
servidor TEF e servidor de banco de dados).
30/7/2012 11:31
Confidencial Auttar
Pg.: 18/30
6. Cadastro do CTF
Cadastro via MENPRI
Ser necessrio efetuar algumas configuraes e cadastros para o funcionamento do produto
CTF. O Menpri responsvel pelo cadastro e manuteno dos arquivos de configurao do CTF, para
acess-lo clique duas vezes no cone do Menpri que ser gerado no desktop aps a instalao do CTF.
Selecione
Cadastra
(Figura 16)
Antes de dar inicio ao processo de cadastro no Menpri, precisamos ter em mos algumas informaes
tais como: cdigo do estabelecimento, nmero da loja, cdigo de origem da autorizadora, DTE(DNA)
para conexo com a VAN e tipo de conexo X.25 ou TCP/iP.
Para navegar no Menpri use as <SETAS> de navegao, <ESC>,<ENTER> e <CTRL+Z>, com essas
funes conseguimos acessa todo o menu do CTF.
30/7/2012 11:31
Confidencial Auttar
Pg.: 19/30
Selecione
ESTABELECIMENTO
(Figura 17)
(Figura 18)
ATENO !
30/7/2012 11:31
Confidencial Auttar
Pg.: 20/30
Preenchimento
Estab
Loja
Nome
Fone
Total de 11 posies numricas, incluindo o DDD e completando com zeros esquerda caso seja
necessrio. Deve ser preenchido por completo.
CGC
Total de 14 posies numricas, preencher com zeros esquerda caso os dados no ocupem o
tamanho mximo do campo. Deve ser preenchido por completo.
Endereo
CEP
Aps preencher todos os campos tecle <CTRL+Z> para voltar ao menu, e selecione a opo Confirma
para gravar os dados.
ATENO !
Cadastro de VANS
Essa interface tem como objetivo, habilitar as VANS e cadastrar os endereos X.25 utilizadas pelo
estabelecimento, portanto, preciso ter em mos o(s) endereo(s) X.25 da(s) VAN(s) utilizada(s) pela
loja.
Para acess-la selecione a opo X.25/vans no item Cadastra do menu principal (Erro! Fonte de
referncia no encontrada.).
Lista de VANS
(Figura 19)
Manual de Instalao e Configurao CTF V1.0.0.doc
30/7/2012 11:31
Confidencial Auttar
Pg.: 21/30
Ser exibida a tela com uma lista de vans disponveis (Figura 20), e um flag que informa se a mesma se
encontra habilitada ou no. Se a VAN estiver habilitada aparecer antes de seu nome o caractere D
(Disponvel).
VAN
disponvel
D
VAN selecionada
para habilitar
(Figura 20)
Selecione SIM
para habilitar a VAN
(Figura 21)
ATENO !
Para habilitar a VAN, apenas precisamos marcar o campo SIM e confirma o cadastro, no
precisa preencher o campo [END. Conexo]. Aps habilitar a VAN as informaes so gravadas
no arquivo VANS.DAT localizado na pasta CTF_CSI\DAD.
30/7/2012 11:31
Confidencial Auttar
Pg.: 22/30
Descrio da sigla ICV : Arquivo com informaes dos canais da Interface de Comunicao com
as VANs.
Tipo do arquivo: ascii
Separador dos campos do registro: ':'
Comentrio dentro do arquivo: '#' na primeira coluna
Altere o arquivo icv.dat que est na pasta default de configurao do CTF em \CTF_AUTTAR\DAD,
conforme figura abaixo:
(Figura 22)
Cada linha do ICV.DAT significa um canal, e para cada canal habilitado ser necessrio configurar o
endereo X.25, porta de conexo TCP/IP como tambm o protocolo de comunicao, conforme
exemplos abaixo:
30/7/2012 11:31
Confidencial Auttar
Pg.: 23/30
Cadastro de Autorizadoras
Aps inserir o estabelecimento e loja, insira as autorizadoras com seus respectivos cdigos.
Para cadastrar os dados relativos s autorizadoras que foram contratadas pelo estabelecimento,
preciso ter em mos os seguintes dados:
ATENO !
Sendo assim, para incluir uma autorizadora, siga os passos do captulo anterior (Erro! Fonte de
referncia no encontrada.), e posteriormente as orientaes descritas a seguir:
1. A partir da Erro! Fonte de referncia no encontrada.23, aps ter selecionado o
estabelecimento desejado, selecione e opo Autorizadoras no menu. Ser exibida a (Figura 24).
Selecione
AUTORIZADORAS
(Figura 23)
30/7/2012 11:31
Confidencial Auttar
Pg.: 24/30
Selecione
INSERIR
(Figura 24)
30/7/2012 11:31
Confidencial Auttar
Pg.: 25/30
Loja
(Figura 25)
4.
(Figura 26)
Para habilitar o uso da autorizadora na loja em questo, habilite a opo SIM na lista
Disponvel.
30/7/2012 11:31
Confidencial Auttar
Pg.: 26/30
Para habilitar o uso da autorizadora na loja em questo, habilite a opo SIM na lista
Disponvel.
Tecle <CTRL Z> para retornar ao menu e selecione Confirma para gravar as informaes. (Figura 27)
(Figura 27)
Caso queira cadastrar uma nova autorizadora basta teclar <CTRL Z> novamente para voltar para o
primeiro campo da interface, que PDV, e seguir o processo normal de cadastro.
Para autorizadora de Crdito Digital:
O formato para este campo da conta crdito :
9999999999
(11 posies para o nmero da concessionria)
ATENO !
30/7/2012 11:31
Confidencial Auttar
Pg.: 27/30
Caso queira alterar ou remover uma autorizadora qualquer, selecione os itens Alterar ou Remover do
menu da tela de Cadastro das Autorizadoras do Estabelecimento (Erro! Fonte de referncia no
encontrada.8).
Uma lista aparecer, mostrando as autorizadoras que foram cadastradas (independente se foram
habilitadas ou no). Para selecionar uma delas, tecle na barra de espao e depois <ENTER>.
Selecione
ALTERAR
(Figura 28)
30/7/2012 11:31
Confidencial Auttar
Pg.: 28/30
Inicializando o CTF
Aps a realizao de todo os procedimentos do roteiro, o CTF est pronto para ser
ativado(inicializado) via servio CTFCONTROL conforme (Figura 18) abaixo:
INICIAR O
SERVIO
CTFCONTROL
(Figura 29)
30/7/2012 11:31
Confidencial Auttar
Pg.: 29/30
Observaes Gerais
A poltica de backup sugerida realiza uma cpia completa dos bancos de dados do CTF, diariamente
durante a madrugada. Ao longo do dia sero realizados diversos backups da rea de transaes
(Transaction Log), a cada 30 minutos. Tambm pode ser agendado um backup diferencial dirio.
Todos estes arquivos so gravados em uma rea do disco a ser definida pelo cliente. Estes backups
possibilitam a recuperao do banco de dados at o momento de uma parada e tambm liberam
rea no Transaction Log.
5) Protocolos de comunicao entre o PDV/Client X CTF
No CTF existe o parmetro 250: no arquivo PARAM.DAT chamado mascara ICC: esse parmetro
responsvel pelos protocolos de comunicao do PDV/Client X CTF, hoje o valor desse parmetro o
sai com o valor DEFAULT de 1294, esse valor corresponde a soma dos protocolos; 0002:Arquivo,
0004:Socket UDP/IP, 0008:Named Pipe, 0256:Socket TCP/IP e 1024:Socket UDP2, o valores desses
protocolos esto definidos no arquivo DESCICC.DAT. Ento caso o protocolo de comunicao seja
diferente ou seja necessrio SOMAR mais algum outros veja qual a forma de comunicao do
PDV/Client do Cliente.
6) VISUALIZER
Para ativar o envio de mensagens de monitorao do CTF para o VISUALIZER necessrio configurar
dois parmetros no CTF, edite o arquivo PARAM.DAT e informe no registro 307: ip da maquina onde
est instalado o VISUALIZER e no registro 309: informe S ou N para ativar o envio de mensagens
para o VISUALIZAR. (Configurar esses registros em todas as instncias de CTF em produo)
Manual de Instalao e Configurao CTF V1.0.0.doc
30/7/2012 11:31
Confidencial Auttar
Pg.: 30/30