Pular para o conteúdo principal

Documentação de Instalação e Configuração - DevBVBS

Requisitos minimos recomendados para a Touchbox:​

  • Processador Intel Celeron ou superior;
  • 4 GB de memória RAM;
  • 2 portas USB;
  • 1 porta serial;
  • SSD de 120 GB;
  • Windows 10 ou superior;
  • Navegador Google Chrome.

É necessário que a Touchbox esteja recém formatada ou feita uma limpeza de disco para evitar aplicativos de terceiros que possam impactar no funcionamento do client DevBVBS.

1. Instalação Automatizada (Recomendada)​

O instalador automatizado realiza o download dos componentes necessários e executa as configurações do ambiente para instalar o client DevBVBS.

1.1 Execução do instalador​

  1. Abra o Windows PowerShell.
  2. Copie o comando abaixo, cole-o no PowerShell e pressione Enter:
irm https://updates.intra.devco.cloud/devbvbs/instalador_windows/install.ps1 | iex
  1. Aguarde o carregamento do menu interativo do instalador.
  2. Selecione a opção [1] para iniciar a instalação.
  3. Siga as orientações apresentadas na tela e aguarde a confirmação de conclusão. Não feche a janela do PowerShell durante o processo.
  4. No menu interativo, existe a opção de instalar o Atualizador automático porém somente utilize se não possuir Active Directory, caso possua comunique a equipe da dev&Co.
NOTA

Para consultar instruções adicionais durante a execução, selecione a opção Ver guia no menu do instalador.

1.2. Validação da instalação​

Após a conclusão do instalador:

  1. Ao fim do processo o totem solicitará que o computador sejá reiniciado.
  2. Ao iniciar aguarde pois o Chrome irá abrir automaticamente a url do sistema e criará um atalho na Área de trabalho.
  3. Também disponivel abrindo o Google Chrome e acessando http://localhost:8080/devbvbs.
IMPORTANTE

Execute somente o comando disponibilizado nesta documentação. Não interrompa o processo enquanto o instalador estiver realizando downloads ou configurações.

Se a instalação automatizada não puder ser concluída, utilize o procedimento manual descrito a seguir.​

2. Instalação Manual (Alternativa)​

2.1. Pré-requisitos: Instalação e Configuração do JDK 17​

  1. Realize o download do instalador do JDK 17 através do repositório oficial: Oracle Java SE 17 Archive.
  2. Execute o arquivo .msi ou .exe obtido e siga as instruções padrão de instalação.
  3. Configure as variáveis de ambiente do sistema operacional:

  • Variáveis de sistema:

  • Nome da variável: JAVA_HOME

  • Valor da variável: C:\Program Files\Java\jdk-17 (ou o diretório correspondente à instalação realizada)

  • Variáveis do Sistema:

  • Localize e selecione a variável Path, mapeada na lista, e clique em Editar.

  • Adicione uma nova entrada com o seguinte valor: %JAVA_HOME%\bin

2.2. Instalação do Sistema​

  1. Baixe o executável de instalação do sistema: DevBVBSClient.
  1. Execute o instalador DevBVBSInstaller-last.exe. Ao término do processo, confirme a solicitação de reinicialização do sistema operacional.

Após a reinicialização, o sistema estará disponível no endereço: http://localhost:8080/devbvbs.

  1. Ao acessar, realize a instalação da página como app, para que fique acessivel tanto do atalho da área de trabalho, como da barra de tarefas:

alt text

Manual de Operação - Client DevBVBS

Esta etapa estabelece o procedimento padrão para inicialização e operação do sistema DevBVBS nos totens.

AVISO PRÉVIO

Durante o processo de abertura do sistema, é terminantemente proibido realizar a leitura de etiquetas, códigos de barras de configuração do leitor ou qualquer outra interação no equipamento. O totem possui configuração prévia e não requer ajustes. Intervenções de configuração são restritas e devem ser direcionadas exclusivamente à equipe Dev&Co.

1. Inicialização do Sistema Localize o atalho do client no totem e execute-o com um único clique sendo na barra de tarefas e dois sendo no atalho da área de trabalho. Observação: O tempo de carregamento pode variar conforme o hardware do totem ou caso tenha sido ligado brevemente. Aguarde o carregamento completo da interface.

alt text

2. Autenticação Na interface de login, clique no botão de login e aguarde. As credenciais de usuário e senha são preenchidas automaticamente. O acesso ao menu de Configurações é bloqueado para operadores e exclusivo para manutenção da Dev&Co.

alt text

3. Identificação do Operador Com o sistema aberto, o operador deve realizar a leitura do seu crachá utilizando o leitor de código de barras. Aguarde a confirmação visual de acesso na tela.

alt text alt text

3.1. Validação de Acesso Em caso de dúvida sobre a confirmação do login, acesse a aba Operadores Ativos. O sistema listará o operador autenticado no momento.

4. Registro de Matéria-Prima Realize a leitura do código de barras da matéria-prima. Após a leitura, verifique na interface se o material consta com o status indicando que está em uso. Exceção: Caso o material processado seja armado, ignore esta etapa e avance diretamente para o passo 5.

alt text

5. Início da Produção Com os passos anteriores validados, inicie a produção realizando a leitura das etiquetas.

alt text

Certifique-se de que a máquina está em modo de recebimento de dados. Este status é comumente indicado no painel pelo ícone de Lápis.

Problemas e Soluções

alt text

  1. Parar o serviço do client:

Services > Apache Tomcat 9.0 DevBVBS

  1. Com o serviço parado, vamos excluir os arquivos do banco de dados que estão causando o problema:

Acesse a pasta: C:\Program Files (x86)\DevBVBS\apache-tomcat

Aqui localizaremos os arquivos do banco de dados, geralmente são: devbvbs.lock.db, devbvbs.mv.db e devbvbs.trace.db. Caso tenha mais algum, ele também poderá ser excluido pois pode ser resquicio de atualizações passadas.

Exclua os arquivos de banco mencionado a cima.

  1. Iniciar o serviço

Na mesma tela do 1º passo, iniciaremos o serviço.

  1. Validação:

Com o serviço iniciado, vamos abrir client DevBVBS e validar a resolução do problema. NOTA: Como excluimos o banco de dados, é comum que o serviço demore de 5 a 10 min para abrir pois está reconstruindo as tabelas e dados, após esse tempo caso ainda não tenha subido, reinicie o totem e valide.

alt text

  1. Reiniciar o serviço

Services > Apache Tomcat 9.0 DevBVBS

  1. Abrir o client em guia anonima pela URL:

http://localhost:8080/devbvbs

  1. Validando a abertura do client, fecha a aba anonima, vá até o histórico do Google Chrome e limpe todo o periodo selecionando todas as flags (Histórico de navegação, Cookies, Imagens, Historico de Downloads)

Abaixo está uma versão revisada. O texto foi ajustado para remover termos coloquiais, evitar ambiguidades e separar as ações em etapas claras e verificáveis.

Reinstalação do Client​

Para preservar as configurações em cenários de reinstalação do sistema (ex: substituição de Touchbox ou formatação), realize o backup prévio dos arquivos do client.

  1. Acesse o diretório: C:\Program Files (x86)\DevBVBS\apache-tomcat
  2. Copie os seguintes arquivos para um diretório de backup externo temporário:
  • login.properties
  • configSerial.properties
  • devbvbs.lock.db
  • devbvbs.mv.db
  • devbvbs.trace.db
  1. Execute a reinstalação do client conforme descrito na seção: Documentação de Instalação e Configuração - BVBS.
  2. Restaure apenas os arquivos login.properties e configSerial.properties no diretório de origem (C:\Program Files (x86)\DevBVBS\apache-tomcat).
  • Nota: Os três arquivos .db copiados na etapa 2 devem ser mantidos apenas no diretório de backup por segurança e não devem ser substituídos na nova instalação.
  1. Inicie o serviço Apache Tomcat 9.0 DevBVBS.