Manual Client SCDE 2 0

Procedimento de instalação e
configuração do ClientSCDE 2.0

Gerência de Engenharia & Operação da Medição – GEOP
02/05/2018
Versão: 1
ÍNDICE
1. Introdução 02
2. Objetivo 02
3. ClientSCDE __________ 02
4. Recursos da Versão 2.0 _____________________ 02
5. Instalação do ClientSCDE 03
6. Funções do ClientSCDE 04
7. Teste de Conexão_____ 06
8. Teste de Coleta_______ 06
9. Manutenção e limpeza de pastas _______ 06
10.Requisitos mínimos para processamento 07
1
1. Introdução
Este procedimento apresenta o aplicativo ClientSCDE na versão 2.0, indicando as

melhorias e novos recursos implementados na nova versão, os passos
necessários para a instalação e configuração do ClientSCDE na UCM e orienta o
agente nos testes que podem ser executados para verificar se a comunicação com
o SCDE está sendo realizada com sucesso.
2. Objetivo
Auxiliar o agente na instalação e configuração do ClientSCDE na UCM, apontando

eventuais erros que possam ocorrer durante o processo e indicando a solução.
3. ClientSCDE
O ClientSCDE é um aplicativo desenvolvido em linguagem Java, responsável pela

transferência de:
 Arquivo gerado por UCM, contendo os dados coletados diretamente dos

medidores;
 Arquivos de alertas do ClientSCDE;
O ClientSCDE é gerado pelo SCDE e deverá estar associado à UCM onde será
instalado.
O aplicativo realizará a leitura das datas e horários de transmissão agendados no

SCDE, comparando-os com o horário atual do sistema. Caso seja o horário
configurado para transmissão de dados, será iniciada a conexão ao SCDE, e o
envio dos arquivos XML disponibilizados na pasta UPLOAD.
4. Recursos da Versão 2.0
 Nova interface gráfica que torna o aplicativo mais interativo com o agente;
 Atualização da compatibilidade da aplicação com Java versão 8;
 Inclusão da Máquina Virtual Java (JVM) para Windows junto com a
aplicação;
 Atualização de segurança com novos certificados provendo uma criptografia
mais segura;
 Melhoria no envio de arquivos para detecção de arquivos já enviados.
2
5. Instalação do ClientSCDE
O pacote ClientSCDE é composto de um arquivo .zip que contém os arquivos

necessários para a instalação e funcionamento do aplicativo.
Antes da execução, para que o ClientSCDE funcione corretamente, é necessário

que o equipamento tenha instalado o pacote do JAVA na versão 1.8. Uma versão
para Windows já está inclusa na pasta lib\jre1.8.0_151 e a mesma será utilizada
em ambiente Windows. Para outros sistemas operacionais, o mesmo deverá ser
instalado manualmente. O download pode ser encontrado no site da Oracle
(https://www.java.com/pt_BR/download/manual.jsp).
O primeiro passo para a instalação do aplicativo é a descompactação do arquivo

client-SCDE. O arquivo pode ser descompactado em qualquer diretório, a única
exceção é que não pode haver espaço em branco no nome do diretório ou
caminho onde ele será descompactado. (ex. ClientSCDE).
É necessário que a UCM em que o ClientSCDE está sendo instalado tenha acesso
permitido ao endereço https://scdec.ccee.org.br e à porta 443 em ambos os
sentidos (permissão para download e upload).
O próximo passo é rodar o arquivo ClientSCDE.bat ou ClientSCDE.sh (depende

do sistema operacional, Windows ou Linux) localizado na raiz do aplicativo. Nesse
instante serão criados outros diretórios, como a pasta UPLOAD onde os arquivos
XML serão disponibilizados para transferência ao SCDE.
Será criada a seguinte estrutura:
\ scde-ucm-client
+---backup
+---config
+---lib
+---logs
+---upload
+---pendentes
+---rejeitados
+---duplicados
+---work
O certificado digital (keystore) deve ser armazenado na pasta CONFIG criada no

ClientSCDE.
A pasta UPLOAD deve armazenar os arquivos XML gerados pelo agente. Quando
um arquivo não é transferido devido a algum erro de estrutura, ele é movido para
a pasta REJEITADOS para que o agente verifique o problema. Quando o arquivo
é transferido mas fica aguardando o processamento pelo SCDE ele é transferido
para a pasta PENDENTES, caso seja processado com sucesso pelo SCDE o arquivo
é transferido para pasta BACKUP, caso contrário será movido para pasta
REJEITADOS. Arquivos idênticos serão transferido apenas uma única vez ao dia,
ou seja, arquivos com conteúdo idêntico a um já enviado serão transferidos para
a pasta DUPLICADOS.
3
Após a execução do arquivo ClientSCDE.bat, a seguinte tela deverá ser
carregada:
Caso não seja visualizada, isso indica que há um problema na versão ou

instalação do JAVA. Deve-se então verificar novamente as configurações e
observar se há outras versões do JAVA na UCM que possam estar conflitando com
a versão 1.8.x.
6. Funções do ClientSCDE
As funções abaixo estão localizadas na tela principal do aplicativo.
Período da Coleta
Período da coleta: informa o período em que o SCDE permite a transferência dos

arquivos XML. Após este período, os arquivos serão transferidos apenas no dia
seguinte.
Status do Sistema
Indica o status da comunicação do ClientSCDE com o SCDE. O status deve indicar

“Operando normalmente”.
4
Arquivos
Transferidos: informa o total de arquivos transferidos para o SCDE no dia.
Sucesso: informa a quantidade de arquivos transferidos e processados com

sucesso pelo SCDE.
Inválidos: informa a quantidade de arquivos transferidos que foram invalidados

pelo SCDE.
Rejeitado Client: informa a quantidade de arquivos não transferidos que foram

invalidados pelo ClientSCDE.
Duplicados: informa a quantidade de arquivos duplicados (conteúdo idêntico) que

foram colocados para upload.
Medidores
Lista a relação de medidores e seu número de série correspondente cadastrados

no SCDE. Cabe ressaltar que se os arquivos XML estiverem com o código de 14
dígitos ou o número de série divergentes ao cadastrado, o arquivo não é
processado com sucesso.
O ClientSCDE só transferirá os arquivos XML dos medidores cadastrados no SCDE,

independente de outros arquivos inseridos na pasta UPLOAD.
Botões
Teste de Conexão: Permite executar um teste para verificar a conectividade entre

o ClientSCDE e o SCDE
Atualizar Medidores: Faz a atualização forçada do arquivo de configuração,

incluindo a lista de medidores cadastrados. Esta atualização é feita diariamente
automaticamente.
Abrir Log: Abre o arquivo de log do dia. Na tela principal é possível visualizar
parte do log, sempre com a informação mais recente.
Gerar Pacote: gera o arquivo ccee.zip na pasta WORK para ser encaminhado para
análise pela CCEE, contendo os logs do ClientSCDE e os arquivos XML rejeitados.
Sair: Permite sair do ClientSCDE. Esta opção fecha o aplicativo.
5
7. Teste de Conexão
Na tela do aplicativo ClientSCDE, há um botão TESTE DE CONEXÃO onde é

possível verificar se a UCM está tendo comunicação com o SCDE. Após sua
execução, se tudo estiver configurado, será exibida a informação de “Conexão
com o Servidor OK”.
Caso não obtenha sucesso no teste, deve ser revista a comunicação da UCM com
a internet, incluindo a permissão de acesso à porta 443. Caso o problema
persista, o agente deve entrar em contato com a CCEE para suporte.
8. Teste de Coleta
O teste de coleta é feito inserindo um arquivo xml válido no diretório UPLOAD. O

arquivo deverá ser transferido e o agente pode verificar se houve sucesso através
das seguintes condições:
 O arquivo xml deverá ser transferido da pasta UPLOAD para BACKUP.

Lembrando que ele só será transferido se o período de coleta estiver
vigente.
 Um arquivo de log, gerado na pasta LOGS indicará que a transferência do
arquivo foi feita com sucesso.
Se o teste não resultar na coleta do arquivo, o agente deve enviar à CCEE o

arquivo gerado através do botão Gerar Pacote, para que sejam feitos testes e
análise do problema pelos analistas da CCEE.
OBS.: Se o agente utilizar Proxy para que a UCM tenha acesso à conexão
dedicada, as informações de IP e Porta do Proxy devem ser informadas à CCEE
para cadastro no
É importante destacar que este Proxy não pode exigir que o ClientSCDE faça
autenticação para acesso à internet ou o aplicativo não funcionará.
9. Manutenção e limpeza de pastas
Ao longo do tempo, algumas pastas acumularão indefinidamente uma grande

quantidade de arquivos como consequência da execução do ClientSCDE (como
descrito no item 5 – Instalação do ClientSCDE). Esses arquivos são importantes
por fornecerem um registro histórico da execução do programa, porém podem
ser apagados quando necessário, seja para liberação de espaço em disco ou
quando esse controle histórico não for mais necessário, por exemplo.
Não há no aplicativo nenhuma rotina de limpeza automática destas pastas, no

entanto, a mesma pode ser feita de forma manual. São pastas seguras para
serem limpas:
6
backup - arquivos que foram enviados com sucesso
upload\rejeitados - arquivos com problemas, não enviados
upload\duplicados - arquivos duplicados, já enviados no dia
logs: - arquivos de log da aplicação
10. Requisitos mínimos para processamento
A seguir estão descritos quais são os requisitos mínimos para realizar o

processamento desta versão do ClientSCDE.
Windows 10 / 8.x / 7 SP1 (32 ou 64 bits)
Memória RAM: mínimo 4GB (8GB recomendado)
Dúvidas e Suporte Técnico
Central de Atendimento:
0800 10 00 08
atendimento@ccee.org.br

Manual Client SCDE 2 0

Enviado por

Direitos autorais:

Formatos disponíveis

Manual Client SCDE 2 0

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Client SCDE 2 0

Enviado por

Direitos autorais:

Formatos disponíveis

Procedimento de instalação e

configuração do ClientSCDE 2.0

4. Recursos da Versão 2.0 _____________________ 02

9. Manutenção e limpeza de pastas _______ 06

10.Requisitos mínimos para processamento 07

Este procedimento apresenta o aplicativo ClientSCDE na versão 2.0, indicando as

Auxiliar o agente na instalação e configuração do ClientSCDE na UCM, apontando

O ClientSCDE é um aplicativo desenvolvido em linguagem Java, responsável pela

 Arquivo gerado por UCM, contendo os dados coletados diretamente dos

O aplicativo realizará a leitura das datas e horários de transmissão agendados no

4. Recursos da Versão 2.0

O pacote ClientSCDE é composto de um arquivo .zip que contém os arquivos

Antes da execução, para que o ClientSCDE funcione corretamente, é necessário

O primeiro passo para a instalação do aplicativo é a descompactação do arquivo

O próximo passo é rodar o arquivo ClientSCDE.bat ou ClientSCDE.sh (depende

Será criada a seguinte estrutura:

O certificado digital (keystore) deve ser armazenado na pasta CONFIG criada no

Caso não seja visualizada, isso indica que há um problema na versão ou

As funções abaixo estão localizadas na tela principal do aplicativo.

Período da coleta: informa o período em que o SCDE permite a transferência dos

Indica o status da comunicação do ClientSCDE com o SCDE. O status deve indicar

Transferidos: informa o total de arquivos transferidos para o SCDE no dia.

Sucesso: informa a quantidade de arquivos transferidos e processados com

Inválidos: informa a quantidade de arquivos transferidos que foram invalidados

Rejeitado Client: informa a quantidade de arquivos não transferidos que foram

Duplicados: informa a quantidade de arquivos duplicados (conteúdo idêntico) que

Lista a relação de medidores e seu número de série correspondente cadastrados

O ClientSCDE só transferirá os arquivos XML dos medidores cadastrados no SCDE,

Teste de Conexão: Permite executar um teste para verificar a conectividade entre

Atualizar Medidores: Faz a atualização forçada do arquivo de configuração,

Sair: Permite sair do ClientSCDE. Esta opção fecha o aplicativo.

Na tela do aplicativo ClientSCDE, há um botão TESTE DE CONEXÃO onde é

O teste de coleta é feito inserindo um arquivo xml válido no diretório UPLOAD. O

 O arquivo xml deverá ser transferido da pasta UPLOAD para BACKUP.

Se o teste não resultar na coleta do arquivo, o agente deve enviar à CCEE o

9. Manutenção e limpeza de pastas

Ao longo do tempo, algumas pastas acumularão indefinidamente uma grande

Não há no aplicativo nenhuma rotina de limpeza automática destas pastas, no

10. Requisitos mínimos para processamento

A seguir estão descritos quais são os requisitos mínimos para realizar o

Windows 10 / 8.x / 7 SP1 (32 ou 64 bits)

Memória RAM: mínimo 4GB (8GB recomendado)

Dúvidas e Suporte Técnico

Você também pode gostar