PDA

Procedimento de Atualizao
Verso 3.01

2009-14 Software Express Informtica Ltda. Todos os direitos reservados . Proibida a reproduo ou divulgao deste documento,
por qualquer processo, mesmo parcialmente, para quaisquer fins, sem a prvia autorizao formal da Software Express.

PDA SiTefWeb

HISTRICO DO DOCUMENTO
Data

Verso

Autor

Descrio

27/09/10

V 1.0

Ricardo Makoto

Verso inicial.

29/10/10

V 1.1

Ricardo Makoto

Nova verso dos exportadores (ExpCli v1.7.0-0 e ExpServ v1.7.0-2)

01/12/10

V 1.2

Ricardo Makoto

Nova verso do exportador ExpServ v1.7.0-10

03/02/11

V 1.3

Ricardo Makoto

Nova verso dos exportadores (ExpServ v1.8.0-4);

24/02/11

V 1.4

Ricardo Makoto

Nova verso dos exportadores (ExpCli v1.7.0-4 e ExpServ v1.8.0-7)

22/03/11

V 1.5

Ricardo Makoto

Nova verso dos exportadores (ExpServ v1.8.0-13);

04/04/11

V 1.6

Eduardo Salgado

Nova verso dos exportadores (ExpServ v1.8.0-17);

15/04/11

V 1.7

Eduardo Salgado

Nova verso dos exportadores (ExpCli v1.7.0-6 e ExpServ v1.8.0-18)

17/05/11

V 1.8

Eduardo Salgado

Nova verso do exportador (ExpServ v1.8.1-0)

18/06/11

V 1.9

Eduardo Salgado

Nova verso do exportador (ExpServ v1.8.1-8)

13/07/11

V 1.10

Ricardo Makoto

Correo no item (1.4 - Arquivos de instalao) para evitar atualizao

excessiva no documento para verses subseqentes dos exportadores.

22/12/14

V 1.11

Fabio Deroide

Atualizao geral do documento.

SOBRE ESTE PROCEDIMENTO

Esta seo apresenta uma breve descrio sobre o procedimento, o pblico alvo, os pr-requisitos
sugeridos e os objetivos.
Descrio

Este procedimento fornece aos colaboradores, clientes ou parceiros o

conhecimento necessrio para atualizar a soluo SiTefWeb.

Pblico-Alvo

Profissionais da rea de TI: Analistas de TI, Tcnicos em Informtica e DBAs.

Pr-Requisitos

Conhecimento da soluo SiTef.

Objetivos

Ensinar o passo-a-passo de como fazer a atualizao e configurao da soluo

SiTefWeb.

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

ndice
CAPITULO 1: Fluxo de Atualizao .......................................................................................................... 5
1.1: Introduo e Objetivos .................................................................................................................. 5
1.2: Pr-Requisitos ............................................................................................................................... 5
1.3: Descrio ...................................................................................................................................... 5
1.4: Pacote de Atualizao ................................................................................................................... 5
1.5: Recomendaes e Ressalvas ....................................................................................................... 5
CAPITULO 2: Desativar Servios .............................................................................................................. 6
2.1: Introduo e Objetivos .................................................................................................................. 6
2.2: Pr-Requisitos ............................................................................................................................... 6
2.3: Descrio ...................................................................................................................................... 6
2.4: ExpCli (Exportador de Logs Cliente SitefWeb Software Express) .......................................... 6
2.5: ExpServ (Exportador de Logs Servidor SitefWeb Software Express) .................................... 7
2.6: SiTefWeb RMI Server ................................................................................................................ 7
CAPITULO 3: Backup dos Arquivos Essenciais ..................................................................................... 8
3.1: Introduo e Objetivos .................................................................................................................. 8
3.2: Pr-Requisitos ............................................................................................................................... 8
3.3: Descrio ...................................................................................................................................... 8
CAPITULO 4: Aplicao Web (SiTefWeb) ................................................................................................ 9
4.1: Introduo e Objetivos .................................................................................................................. 9
4.2: Pr-Requisitos ............................................................................................................................... 9
4.3: Atualizao SiTefWeb ................................................................................................................... 9
CAPITULO 5: Exportadores ..................................................................................................................... 13
5.1: Introduo e Objetivos ................................................................................................................ 13
5.2: Pr-Requisitos ............................................................................................................................. 13
5.3: Descrio .................................................................................................................................... 13
5.4: Atualizao do ExpServ .............................................................................................................. 13
5.5: Configurao do ExpServ ........................................................................................................... 15
5.6: Atualizao do ExpCli ................................................................................................................. 17
5.7: Configurao do ExpCli............................................................................................................... 19
CAPITULO 6: Ativao dos Servios ..................................................................................................... 20
6.1: Introduo e Objetivos ................................................................................................................ 20
6.2: Pr-Requisitos ............................................................................................................................. 20
6.3: Descrio .................................................................................................................................... 20
6.4: ExpCli (Exportador de Logs Cliente SitefWeb Software Express) ........................................ 20
6.5: ExpServ (Exportador de Logs Servidor SitefWeb Software Express) .................................. 21
6.6: SiTefWeb RMI Server .............................................................................................................. 22
CAPITULO 7: Acessando os relatrios do SiTefWeb. .......................................................................... 23
7.1: Introduo e Objetivos ................................................................................................................ 23
7.2: Pr-Requisitos ............................................................................................................................. 23
7.3: Verificao do Java ..................................................................................................................... 23
7.4: Configurao do Internet Explorer .............................................................................................. 26
www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

7.5: Configurao do Mozilla Firefox: ................................................................................................. 27

7.6: Primeiro Acesso .......................................................................................................................... 28

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

CAPITULO 1: Fluxo de Atualizao

1.1: Introduo e Objetivos
Neste captulo apresentamos o Fluxo da Atualizao da soluo SiTefWeb.

1.2: Pr-Requisitos

Documento CHK Check-List devidamente preenchido/respondido.

1.3: Descrio
Este fluxo tem como objetivo facilitar o entendimento do leitor, ilustrando a seqencia de atualizao.

1.4: Pacote de Atualizao

COMPONENTES

ARQUIVOS DE ATUALIZAO

APLICAO WEB

SITEFWEB.ZIP

EXPORTADORES

EXPCLI-Vx.x.x-x.ZIP
EXPSERV-Vx.x.x-x.ZIP

1.5: Recomendaes e Ressalvas

Certifique-se que o documento CHK Check-List tenha sido totalmente preenchido e encaminhado ao
Suporte SiTefWeb/Conciliao da Software Express.
Importante: A soluo SiTefWeb permanecer indisponvel durante todo o perodo da atualizao. O tempo total da indisponibilidade
poder variar conforme as caractersticas de hardware e capacidade de processamento dos servidores, principalmente o do Banco de
Dados.

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

CAPITULO 2: Desativar Servios

2.1: Introduo e Objetivos
Neste captulo apresentamos como parar os servios dos Exportadores (ExpServ e ExpCli) e SitefWeb RMI Server.

2.2: Pr-Requisitos

Acesso a console dos servidores SiTef, e Aplicao Web com usurio administrador.

2.3: Descrio
Os servios dos Exportadores (ExpCli e ExpServ) e SitefWeb RMI Server efetuam acesso ao Banco de
Dados da soluo, sendo obrigatrio desabilitar tais servios para prosseguir com atualizao.

2.4: ExpCli (Exportador de Logs Cliente SitefWeb Software Express)

2.4.1.

V em Iniciar > Executar e digite services.msc, para acessar ao Painel de Servios do Windows.

2.4.2.

No servidor do SiTef pare o servio Exportador de Logs Cliente - SiTefWeb - Software

Express.

Importante: Caso tenha mais de um servidor SiTef, repita este procedimento nos demais servidores para desativar o servio ExpCli de
todos eles. Certifique-se o servio esteja desativado em todos servidores SiTef antes de prosseguir.

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

2.5: ExpServ (Exportador de Logs Servidor SitefWeb Software Express)

2.5.1.

No servidor da Aplicao Web pare o servio Exportador de Logs Servidor - SiTefWeb Software Express.

2.6: SiTefWeb RMI Server

2.6.1.

No servidor da Aplicao Web pare o servio SiTefWeb - RMIServer.

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

CAPITULO 3: Backup dos Arquivos Essenciais

3.1: Introduo e Objetivos
Neste captulo apresentamos a lista de arquivos essenciais que devem ser copiados antes de processo de
atualizao da aplicao e de seus componentes. O Backup deve ser feito a fim de garantir o retorno para a
verso anterior em caso de uma atualizao mal sucedida.

3.2: Pr-Requisitos

Parar os Servios dos Exportadores (ExpCli e ExpServ) e o Servio do RMI Server, de acordo
com o Capitulo 2.

3.3: Descrio

Realizar Backup Full da instncia do Banco de Dados utilizada pelo SiTefWeb.

No diretrio INETPUB, realizar Backup da pasta CONF, que encontra-se no caminho a seguir:
C:\Inetpub\wwwroot\sitefweb\applet\RMIServer\conf

No diretrio EXPCLI, realizar Backup da pasta CONFIG, que encontra-se no caminho a seguir:
C:\ExpCli\Config

No diretrio EXPSERV, realizar Backup da pasta CONFIG, que encontra-se no caminho a seguir:
C:\ExpServ\Config

Importante: Para localizar os arquivos, observe em qual unidade raiz foi realizada a instalao. Citamos a unidade C:\ apenas como
exemplo de busca.

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

CAPITULO 4: Aplicao Web (SiTefWeb)

4.1: Introduo e Objetivos
Neste captulo o instalador atualizar as tabelas, ndices e componentes do Banco de Dados e tambm
atualizar as pginas Web da soluo.

4.2: Pr-Requisitos

Acesso ao console do servidor da Aplicao Web, preferencialmente com usurio administrador.

Usurio e Senha do Banco de Dados.

4.3: Atualizao SiTefWeb

4.3.1.

No servidor da Aplicao Web, crie um diretrio C:\SE_PCT e descompacte o arquivo

SITEFWEB.ZIP.

4.3.2.

D duplo clique em SETUP.EXE

www.softwareexpress.com.br
(+55) (11) 3170-6700

PDA SiTefWeb

4.3.3.

Na tela Bem-vindo ao SiTefWeb, clique em Prximo.

4.3.4.

Na tela Atualizao do Banco de Dados, selecione a opo Atualizao do banco de Dados

(Recomendado) e clique em Prximo.

Importante: A opo Criar script a ser executado no Banco de Dados poder ser utilizada caso o DBA do cliente desejar executar
o script para criao das tabelas do BD manualmente.
www.softwareexpress.com.br
(+55) (11) 3170-6700

10

PDA SiTefWeb

4.3.5.

Ao receber a mensagem Banco atualizado com sucesso! clique em Prximo.

4.3.6.

Na tela Selecione pacotes de instalao, mantenha o padro e clique em Prximo.

www.softwareexpress.com.br
(+55) (11) 3170-6700

11

PDA SiTefWeb

4.3.7.

Na tela Instalao, aguarde o trmino da instalao e clique em Prximo.

4.3.8.

Na tela Instalao terminada clique em Pronto para concluir a instalao.

www.softwareexpress.com.br
(+55) (11) 3170-6700

12

PDA SiTefWeb

CAPITULO 5: Exportadores
5.1: Introduo e Objetivos
Neste captulo apresentamos procedimento de atualizao dos mdulos exportadores ExpServ e ExpCli.

5.2: Pr-Requisitos

Acesso ao console dos servidores SiTef e o da Aplicao Web com usurio administrador.

Todos os servios da soluo parados, de acordo com o Captulo 2.

5.3: Descrio
Os mdulos exportadores ExpServ e ExpCli so responsveis por exportar as transaes do
Espelho.Log do SiTef para o Banco de Dados da soluo SiTefWeb.

5.4: Atualizao do ExpServ

O mdulo exportador ExpServ um aplicativo server do conceito client/server, que recebe as transaes
TEF do mdulo exportador ExpCli por meio do protocolo TCP/IP na porta 7654, e registra estas
transaes no Banco de Dados da soluo atravs de uma conexo ODBC.
5.4.1.

No servidor da Aplicao Web, crie um diretrio C:\SE_PCT e descompacte o arquivo EXPSERVVX.X.X-XX.ZIP.

5.4.2.

No diretrio C:\SE_PCT\EXPSERV-VX.X.X-XX, d duplo clique no arquivo INSTALA.EXE.

www.softwareexpress.com.br
(+55) (11) 3170-6700

13

PDA SiTefWeb

5.4.3.

Na tela de boas vindas, clique em Next.

5.4.4.

Na tela seguinte, escolha o diretrio de destino da instalao. Em seguida, clique em Next.

www.softwareexpress.com.br
(+55) (11) 3170-6700

14

PDA SiTefWeb

5.4.5.

Aguarde o progresso da instalao atingir 100%.

5.4.6.

Aps a concluso da instalao, clique em Finish.

5.5: Configurao do ExpServ

5.5.1.

Utilize o ExpServ.ini j existente. Caso seja necessrio realizar alguma configurao, proceda de
acordo com a orientao do item 5.5.2. Se no houver necessidade, prossiga para o item 5.6
Atualizao do ExpCli.

www.softwareexpress.com.br
(+55) (11) 3170-6700

15

PDA SiTefWeb

5.5.2.

Abra o arquivo EXPSERV.INI, localize a sesso [BancoDeDados] e configure:

USER Informe o nome de usurio do Banco de Dados;

PASSWORD Informe a senha de acesso ao Banco de Dados;
NOMEODBC Equivale ao nome da conexo ODBC (J existente);
TIPO DO BANCO DE DADOS Retire o ponto e vrgula da linha correspondente ao Banco de
Dados utilizado.
Importante: Aps realizar as configuraes descritas acima, v em Arquivo > Salvar, para confirmar as alteraes. Para maiores
detalhes sobre a configurao do ExpServ, consulte o Guia do Administrador SiTef-Conciliao.

www.softwareexpress.com.br
(+55) (11) 3170-6700

16

PDA SiTefWeb

5.6: Atualizao do ExpCli

O mdulo exportador ExpCli um aplicativo client do conceito client/server, que l as transaes TEF do
Espelho.Log do SiTef e as envia por meio do protocolo TCP/IP para o mdulo exportador ExpServ, que
se encarrega de registrar estas transaes no Banco de Dados da soluo SiTefWeb.
5.6.1.

No servidor do SiTef, crie um diretrio C:\SE_PCT e descompacte o arquivo EXPCLI-VX.X.XXX.ZIP.

5.6.2.

No diretrio C:\SE_PCT\EXPCLI-VX.X.X-XX, d duplo clique no arquivo INSTALA.EXE.

5.6.3.

Na tela de boas vindas, clique em Next.

www.softwareexpress.com.br
(+55) (11) 3170-6700

17

PDA SiTefWeb

5.6.4.

Na tela seguinte, escolha o diretrio de destino da instalao. Em seguida, clique em Next.

5.6.5.

Aguarde o progresso da instalao.

5.6.6.

Aps a concluso da instalao, clique em Finish.

www.softwareexpress.com.br
(+55) (11) 3170-6700

18

PDA SiTefWeb

5.6.7.

No caso de possuir mais de um servidor SiTef, repetir o processo de instalao e configurao do

Mdulo ExpCli nos demais servidores. Mas no se esquea de configurar os paramentos em
destaque da sesso [EXPCLI]:

idCliente= a identificao do Mdulo ExpCli que deve ser nica para cada Mdulo do ExpCli
instalado.
Importante: Aps realizar as configuraes descritas acima, v em Arquivo > Salvar, para confirmar as alteraes. Para maiores
detalhes sobre a configurao do ExpServ, consulte o Guia do Administrador SiTef-Conciliao.

5.7: Configurao do ExpCli

5.7.1.

Utilize o ExpCli.ini j existente. Caso seja necessrio realizar alguma configurao, proceda de
acordo com a orientao do item 5.7.2. Se no houver necessidade, prossiga para o Capitulo 6
Ativao de Servios.

5.7.2.

Abra o arquivo EXPCLI.INI, localize a sesso [EXPSERV] e configure:

EnderecoIP= Substitua o valor atual pelo endereo IP do servidor onde instalamos o EXPSERV.
PortaNum=7654 a porta padro de conexo com o EXPSERV, recomendamos no alterar este
valor.
www.softwareexpress.com.br
(+55) (11) 3170-6700

19

PDA SiTefWeb

CAPITULO 6: Ativao dos Servios

6.1: Introduo e Objetivos
Neste captulo apresentamos procedimento para ativao dos servios da soluo SitefWeb.

6.2: Pr-Requisitos
Acesso ao console dos servidores SiTef e da Aplicao Web com usurio administrador.

6.3: Descrio
Os servios dos Exportadores (ExpCli e ExpServ) e o do SitefWeb RMI Server efetuam acesso ao Banco
de Dados da soluo, sendo obrigatrio ativar tais servios para correto funcionamento da soluo.

6.4: ExpCli (Exportador de Logs Cliente SitefWeb Software Express)

6.4.1.

V em Iniciar > Executar e digite services.msc, para acessar ao Painel de Servios do Windows.

6.4.2.

No servidor do SiTef, inicie o servio Exportador de Logs Cliente - SiTefWeb.

www.softwareexpress.com.br
(+55) (11) 3170-6700

20

PDA SiTefWeb

6.4.3.

Ao iniciar o servio a seguinte janela surgir Exportador de Logs Cliente.

6.5: ExpServ (Exportador de Logs Servidor SitefWeb Software Express)

6.5.1.

No servidor da Aplicao Web, inicie o servio Exportador de Logs Servidor SiTefWeb.

6.5.2.

Ao iniciar o servio a seguinte janela surgir: Exportador de Logs Servidor.

www.softwareexpress.com.br
(+55) (11) 3170-6700

21

PDA SiTefWeb

6.6: SiTefWeb RMI Server

6.6.1.

No servidor da Aplicao Web, inicie o servio SiTefWeb - RMIServer.

www.softwareexpress.com.br
(+55) (11) 3170-6700

22

PDA SiTefWeb

CAPITULO 7: Acessando os relatrios do SiTefWeb.

7.1: Introduo e Objetivos
Neste captulo apresentamos como configurar o navegador de internet da sua estao de trabalho,
identificar a tela de acesso do sistema SiTefWeb e como realizar o primeiro acesso ao sistema. Depois de
concluir este capitulo voc ser capaz de:
Verificar e configurar o Java.
Configurar o navegador de internet para acessar o sistema.
Identificar a tela inicial de acesso a aplicao.
Acessar a aplicao.

7.2: Pr-Requisitos
Estao de trabalho com acesso a rede interna de sua empresa.
Navegador de internet devidamente instalado.
Java plug-in (JRE) instalado (Verificar a verso mais recente disponvel no site do fabricante).
Importante: O pacote Java plug-in (JRE) gratuito e pode ser obtido para download e instalao no site www.java.com.

7.3: Verificao do Java

7.3.1.

No servidor da Aplicao Web, abra uma janela do Prompt de Comando e execute o comando
Java -version.

IMPORTANTE: Caso o Java esteja devidamente instalado e o comando no funcionar, adicione o Path do Java s Variveis de
Ambiente do sistema operacional, conforme passo a passo a seguir:
1) Iniciar > Painel de Controle > Sistema;
2) Aba Avanado > Variveis de Ambiente;
3) Em Variveis do Sistema localizar o Path e clicar em Editar;
4) Informar o Path do Java de acordo com o sistema operacional utilizado.
Obs.: No apagar as informaes j contidas nas Variveis de Ambiente, apenas acrescentar a Path do Java, separando as
informaes com ponto e vrgula.

www.softwareexpress.com.br
(+55) (11) 3170-6700

23

PDA SiTefWeb

7.3.2.

V ao Painel de controle do Java (Iniciar > Painel de Controle > Java), localize a aba Segurana e
clique em Editar Lista de Sites.

7.3.3.

Na janela Lista de Excees de Sites, clique em Adicionar e inclua o IP do Servidor ou o nome

do Servidor SiTefWeb na lista de excees. Em seguida, clique em OK.

www.softwareexpress.com.br
(+55) (11) 3170-6700

24

PDA SiTefWeb

7.3.4.

No Painel de Controle do Java, na aba Avanados, marque as seguintes opes:

Depurao:
Ativar Rastreamento
Ativar log
Console Java:
Mostrar console
Java Padro para browsers:
Famlia Mozilla
Criao de Atalho:
Perguntar ao usurio se for sugerido
Associao de arquivo JNLP/MIME:
Perguntar ao usurio
Instalao da Aplicao:
Instalar se houver dica
Ambiente de Execuo Seguro:
Permitir que o usurio conceda permisses (...)
Exibir o banner de advertncia do sandbox
Permitir que o usurio aceite as solicitaes de segurana do JNLP
No solicitar a seleo de certificados do cliente (...)
Avisar se o certificado do site no corresponder ao nome do host
Verificao de segurana de cdigo misto (Sandboxed vs. Confivel):
Desativar verificao
Executar verificaes de revogao do certificado:
Todos os certificados na cadeia de confiana
Verificar a Revogao do certificado usando:
Listas de revogao do Certificado (CRLs)
Definies de Segurana Avanadas:
Usar certificado e chaves no armazenamento de chaves do browser
Usar SSL 3.0
Usar TLS 1.0
Usar TLS 1.1
Usar TLS 1.2
Diversos:
Colocar cone Java na bandeja do sistema

www.softwareexpress.com.br
(+55) (11) 3170-6700

25

PDA SiTefWeb

7.4: Configurao do Internet Explorer

7.4.1.

Abra o navegador Internet Explorer, clique no menu Ferramentas e acesse o subitem Opes da
Internet.

7.4.2.

Na janela Opes da Internet, clique na aba Conexes, depois no boto Configuraes da

LAN.

7.4.3.

Na janela Configuraes da Rede Local (LAN), marque as opes Usar um servidor Proxy
para a rede local e No usar proxy para endereos locais. Preencha os campos Endereo e
Porta de acordo com as configuraes e caractersticas de sua rede, depois clique no boto
Avanadas.

Importante: Pea ao administrador de rede para realizar as configuraes de Proxy. necessrio conhecer as definies da rede para
configur-lo corretamente.

www.softwareexpress.com.br
(+55) (11) 3170-6700

26

PDA SiTefWeb

7.4.4.

Na janela Configuraes de Proxy, digite o endereo IP do servidor SiTefWeb no campo

Excees No usar proxy para os endereos iniciados por, depois clicar no boto OK para
aceitar as configuraes.

7.5: Configurao do Mozilla Firefox:

7.5.1.

Abra o navegador Mozilla Firefox, clique no menu Ferramentas e acesse o subitem Opes.

7.5.2.

Na janela Opes, clique no item Avanado, depois na aba Rede e depois no boto
Configurar Conexo.

www.softwareexpress.com.br
(+55) (11) 3170-6700

27

PDA SiTefWeb

7.5.3.

Na janela Configurar conexo, marque a opo Configurao manual de proxy e preencha

os campos HTTP e Porta de acordo com as configuraes e caractersticas de sua rede. No
campo Sem proxy para, adicione o endereo IP do servidor SiTefWeb, depois clicar no boto
OK para aceitar as configuraes.

Importante: Pea ao administrador de rede para realizar as configuraes de Proxy. necessrio conhecer as definies da rede para
configur-lo corretamente.

7.6: Primeiro Acesso

Abra o seu navegador de internet e digite o endereo IP ou Nome do servidor SitefWeb, seguido pelo nome
da aplicao: /sitefweb.
Ex: http://nomedoservidor/sitefweb ou http://xxx.xxx.xxx.xxx/sitefweb
(xxx.xxx.xxx.xxx corresponde ao endereo IP do servidor SitefWeb).

***Fim do Documento***
www.softwareexpress.com.br
(+55) (11) 3170-6700

28