Machine Translated by Google

EDMS Nº. REV. VALIDADE

0000000 1,0

RASCUNHO

REFERÊNCIA

XXXX

Data: 28-04-2016

VersãoCão

Guia de usuario

Este documento descreve as funcionalidades básicas

de versiondog UserClient

DOCUMENTO PREPARADO POR: DOCUMENTO VERIFICADO POR: DOCUMENTO APROVADO POR:

Marcin Bes [BE-ICS] Jerônimo Ortola Vidal

[BE-ICS]
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 2 de 20

HISTÓRICO DE MUDANÇAS

REV. NÃO. ENCONTRO PÁGINAS DESCRIÇÕES DAS MUDANÇAS

1,0 13 de outubro de 2014 1-12 Primeira versão (M. Bes)

2,0 04 de abril de 2016 1-20 Atualização (M. Bes)
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 3 de 20

ÍNDICE
1. Introdução................................................. .................................................. ...... 4

2. Tornando-se um usuário versiondog ............................................. ....................................... 5

2.1 Instalação do cliente versiondog.............................................. ......................... 5
2.2 Solicitação de conta de usuário. .................................................. .............................. 5

3. Primeiro login ................................................. .................................................. ........... 5

3.1 Configuração dos servidores ............................................. ......................... 6

4. Fazendo check-out de projetos do servidor ........................................ .......................... 8

4.1 Diretórios do servidor ......................................... .............................................. 8
4.2 Saída ....................................................... .................................................. ......... 9

5. Criando um novo projeto .................................................. ............................................. 10

6. Trabalhando com projeto ............................................. .............................................. 13

6.1 Arquivo local................................................. .................................................. ..13
6.2 Modificando um projeto ......................................................... .......................................... 14
6.3 Criando uma nova versão local ............................................. .................................... 14
6.4 Comparando versões locais ............................................. ..............................17
6.5 Trabalho padrão ............................................. .................................................. ...17

7. Check-In (armazenando a versão local no servidor)................................... ..............................18

8. Trabalhos – ações agendadas do versiondog ............................................. ..............................19

8.1 Solicitação de configuração de trabalho ............................................. ..............................19
8.2 Verificando os resultados dos Trabalhos ............................................. .......................................20
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 4 de 20

1. Introdução

versiondog é um software dedicado ao gerenciamento de projetos de PLC. Os principais objetivos do versiondog são:
• gerenciamento de versão e backup
• backup de dados
• relatórios
• gestão da qualidade

versiondog é um software com arquitetura cliente/servidor conforme ilustrado abaixo:

Figura 1 Exemplo de modelo cliente-servidor

Todos os projetos são armazenados em servidores, enquanto os clientes são distribuídos entre os computadores dos usuários.
Toda vez que o usuário faz check-out do projeto do servidor, os arquivos são copiados para sua máquina local e podem ser
modificados, testados e versionados localmente. Após aplicar as alterações, o usuário faz check-in no servidor com a nova versão
do projeto. O histórico de alterações é mantido com uma contribuição mínima de um usuário.

O desenvolvimento de um código PLC é mantido fora do versiondog e ainda é feito com ferramentas dedicadas como Simatic
Step7 ou Unity.

versiondog possui um mecanismo de agendamento chamado Jobs que cria automaticamente um backup do programa em
execução em um dispositivo e verifica a coerência do programa recuperado com uma versão armazenada no servidor.

O serviço de versiondog na infraestrutura do CERN é fornecido para gerenciar projetos em produção e não em
desenvolvimento.
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 5 de 20

2. Tornando-se um usuário versiondog

2.1 Instalação do cliente versiondog

A instalação é descrita em um documento “versiondog InstallationGuide”.

2.2 Solicitação de conta de usuário.

Para usar versiondog você precisa de uma conta de usuário. Ele será criado pelo administrador do grupo responsável por
gerenciar o grupo ao qual você pertence ou você pode solicitá-lo enviando uma solicitação para Icecontrols.support@cern.ch.

Seu nome de usuário deve ser o mesmo que o login da sua conta NICE. Ao fazer login no cliente versiondog, use a senha da sua
conta NICE e você será autenticado pelo sistema operacional.

3. Primeiro login
Depois de ter sua conta e o cliente versiondog instalado em sua máquina, você pode iniciá-lo escolhendo UserClient no menu
Iniciar:

Figura 2 diretório versiondog no menu Iniciar

Os outros clientes instalados ao lado do UserClient são:

- AdminClient – uma ferramenta para administradores

- EasyClient – versão muito simplificada, mas limitada do UserClient

- ReportClient – ferramenta para monitoramento online de alterações no sistema versiondog como check-ins, check-outs,
criação de novas versões, resultados de jobs, etc.

Ao iniciar a janela de login do UserClient aparecerá:

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 6 de 20

Figura 3 janela de login UserClient versiondog

3.1 Configuração dos servidores

O instalador do Versiondog já contém a configuração do servidor, portanto não é necessário configurá-lo manualmente.

Em caso de falta de configuração (como na figura abaixo), siga as instruções.

Para especificar uma conexão com o servidor versiondog CERN, selecione “Configurações do servidor…” no menu suspenso:

Figura 4 Configurando o novo servidor

Nas próximas janelas, escolha “Adicionar um servidor”, digite o nome da configuração (qualquer nome desejado) e o nome do
servidor versiondog (vdog-srv-01). Deixe a configuração de portas com valores padrão:
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 7 de 20

Figura 5 Configuração do servidor

Uma vez inseridos os valores, salve a configuração e feche a janela.

Agora você pode fazer login usando seu nome de usuário e senha NICE (digite CERN no campo de domínio):

Figura 6 Janela de login

Na primeira execução, você será solicitado a configurar o servidor paralelo:

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 8 de 20

Figura 7 Configuração do servidor paralelo

Coloque os nomes como na imagem acima e confirme clicando em OK.

4. Fazendo check-out de projetos do servidor

4.1 Diretórios do servidor

Para ver o que está armazenado no servidor, você pode clicar em “Mostrar diretórios do servidor”

Figura 8 Diretórios do servidor

Depois de verificar este campo, você pode ver a estrutura atual dos projetos no servidor (fonte cinza).

Na seção "Visão geral do componente" você pode ver todos os projetos (no versiondog chamados "componentes") armazenados
no caminho selecionado:

Figura 9 Lista de projetos

Você deve ver apenas os projetos dentro do diretório preparado para o grupo ao qual pertence.
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 9 de 20

4.2 Saída
Para baixar um projeto do arquivo do servidor para o arquivo local, selecione uma ou mais entradas na lista e escolha “Check-Out
(take selection)”:

Figura 10 Check-out de itens selecionados

Na próxima janela você pode selecionar ou desmarcar projetos a serem copiados movendo-os entre o lado esquerdo (servidor) e
o lado direito (sua seleção).

Figura 11 Copiar do servidor para o local

Ao copiar projetos, você pode definir:

- O número de versões a serem copiadas do servidor (para que você possa ver o histórico de
mudanças)

- A caixa de seleção "Em desenvolvimento" - você pode deixar uma informação para outros usuários que
este projeto está atualmente processado e ninguém deve tocá-lo.

Você pode até bloquear o acesso ao projeto, para que ninguém mais possa armazenar uma versão mais recente deste
projeto antes de fazer isso:
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 10 de 20

Figura 12 Em desenvolvimento

Depois de fazer sua seleção, clique em “Copiar todos os componentes selecionados do servidor para o local”
botão. Quando a cópia estiver concluída, você verá o status ao lado de cada componente:

Figura 13 Estado de check-out

A janela Check-Out pode ser fechada.

5. Criando um novo projeto

Para criar um novo projeto, primeiro crie um novo diretório para ele em um local apropriado na hierarquia do espaço de trabalho do
seu grupo.

Se não houver uma estrutura de diretório preparada para o seu projeto, entre em contato com o administrador do grupo para
obter instruções sobre como proceder.

Sua hierarquia de diretórios de arquivo local deve corresponder à hierarquia de diretórios no servidor:

Figura 14 Criando novo diretório

Uma vez que o diretório é criado, você pode criar um novo “componente” dentro:
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 11 de 20

Figura 15 Criando novo componente

Na próxima etapa escolha que tipo de projeto será armazenado neste local (S7/Unity/TIA, etc):

Figura 16 Gerenciador de componentes

Depois de fazer sua seleção, escolha “Criar componente”.

Na forma atual, o componente criado está vazio e você deve fornecer arquivos de projeto.

Figura 17 Projeto vazio

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 12 de 20

Para fazer isso, basta selecionar “Abrir gerenciador de arquivos” e isso abrirá o diretório preparado para o seu
projetos. É suficiente copiar e colar seus arquivos de projeto neste diretório:

Figura 18 Diretório do projeto S7

Figura 19 Diretório do projeto Unity

Neste ponto, você criou apenas um componente com arquivos de projeto. É apenas uma cópia de trabalho e nenhuma versão
local do seu projeto foi criada.
Para criar a versão base com os arquivos fornecidos, selecione “Create base version”.

É uma boa prática renomear um componente criado para que seja mais fácil encontrá-lo na lista de projetos.
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 13 de 20

Figura 20 Renomeando um componente

6. Trabalhando com projeto

6.1 Arquivo local

Durante o desenvolvimento, o projeto é armazenado em seu arquivo local (por padrão, o diretório C:\vdClientArchive). Você pode
ver e modificar sua estrutura na árvore do projeto. A fonte preta corresponde às entradas armazenadas em sua máquina, cinza
– as do servidor.

Figura 21 Representação em árvore do projeto do arquivo local (preto) e arquivo do servidor (cinza)

Abaixo você pode ver os projetos armazenados no arquivo:

Figura 22 Lista de projetos no arquivo local

Para começar a trabalhar em um dos projetos clique duas vezes na linha correspondente ou expanda o
Árvore de projeto até chegar ao seu componente:

Figura 23 Vista de projeto único

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 14 de 20

A parte superior da janela apresenta um resumo do projeto. Na parte inferior você tem uma lista de versões em seu arquivo local
(no exemplo apenas a inicial).

6.2 Modificando um projeto

Para criar uma nova versão é necessário introduzir alterações no projeto. Você pode abrir um editor
(Unity, Simatic, etc) diretamente do versiondog:

Figura 24 Iniciando um editor

Quando suas alterações forem feitas, você verá que “Editar estado” não é mais “Igual”, mas “Diferente”:

Figura 25 Estado de edição “diferente”

6.3 Criando nova versão local

Assim que você considerar que suas alterações na cópia de trabalho foram concluídas, você pode criar uma nova versão
local. Para fazer isso, selecione “Criar nova versão” no menu da faixa de opções ou no menu do botão direito:

Figura 26 Criando nova versão

Quando você cria uma nova versão, o versiondog procura por diferenças e fornece um relatório:
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 15 de 20

Figura 27 Relatório de alterações

Depois de aceitar as alterações, coloque um motivo de alteração para a nova versão e clique em “Nova versão”. Você também
pode apresentar motivos de mudança detalhados para cada parte do projeto:

Figura 28 Motivo da alteração

Como resultado, você tem agora duas versões do seu projeto:

Figura 29 Várias versões de um projeto

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 16 de 20

Você também pode criar uma nova versão sem nenhuma alteração (Extras->Versão sem diferença), mas geralmente não
há uma boa razão para duplicar versões.

O status da comparação “Local<->Server” foi atualizado e agora mostra:

Figura 30 Status do “Servidor <-> Local”

Analogamente, o status “Servidor mais recente que o cliente” significaria que alguém fez check-in no servidor com a nova
versão e o que está no Arquivo local não está atualizado. Para evitar tais situações, sempre faça o check-out com a opção
“Bloquear para outros usuários”.

6.3.1 Criando nova versão sem comparação

Em algumas situações, a comparação pode ser uma etapa indesejada, pois é demorada. Você pode criar uma nova
versão sem comparação selecionando Versão sem Diferença:

Figura 31 Versão sem diferença

Versiondog não irá comparar a versão criada e apenas perguntará sobre um comentário:

Figura 32 Comentando a nova versão sem diferença

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 17 de 20

6.4 Comparando versões locais

Ao selecionar a versão na lista, você obterá informações detalhadas sobre as alterações em comparação com a versão anterior:

Figura 33 Diferenças entre as duas últimas versões

Para obter informações mais detalhadas (como quando você cria uma nova versão), você pode solicitar uma comparação
detalhada:

Figura 34 Obtendo diferenças detalhadas

Em geral, é possível comparar quaisquer duas versões na lista e comparar qualquer versão com a cópia de trabalho:

Figura 35 Comparar opções

6.5 Trabalho padrão

Para cada projeto, um dos trabalhos (um comando agendado pelo GroupAdmin) pode ser selecionado como “trabalho padrão”
para o componente.
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 18 de 20

Se o seu projeto tiver seu “trabalho padrão”, você pode usar a funcionalidade chamada “Carregar e comparar”.
Desta forma pode solicitar o upload do programa ao PLC e compará-lo com a sua cópia de trabalho.

Se a funcionalidade Carregar e comparar não estiver disponível (em cinza), entre em contato com o administrador para configurar
essa funcionalidade.

Figura 36 Carregar e comparar

7. Check-In (armazenando a versão local no servidor)

Para enviar sua versão local para o servidor selecione seu projeto e escolha “Check-In (take selection)”:

Figura 37 Fazendo check-in de um projeto

Para o processo de check-in, uma nova janela é exibida:

Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 19 de 20

Figura 38 Gerenciador de cópia local para servidor

Aqui você pode selecionar quais projetos deseja enviar para o servidor.

Por padrão, a caixa de seleção "Redefinir estado de trabalho" está marcada para remover o bloqueio do projeto ou o status "em
desenvolvimento" para liberar o projeto para outros usuários.

Depois de clicar em “Copiar todos os componentes selecionados do local para o servidor”, a versão é copiada e, como
resultado, você receberá informações sobre o estado do check-in:

Figura 39 Estado de check-in bem-sucedido

Além disso, o status “Local <-> Servidor” deve ser “Igual”:

Figura 40 “Local <-> Servidor” Estado igual

8. Jobs – ações agendadas versiondog

8.1 Solicitação de configuração de trabalho

Para cada projeto armazenado no servidor, o administrador do grupo pode configurar o Job. Job é um comando
programado que, dependendo da configuração, irá:

- Carregar dados do projeto de um PLC

- Salve esses dados como backup no servidor
Machine Translated by Google

REFERÊNCIA EDMS Nº. REV. VALIDADE

XXXX 0000000 1,0 RASCUNHO

Página 20 de 20

- Compare o backup salvo com: backup anterior e/ou versão mais recente do servidor.

O trabalho será executado periodicamente nas máquinas dos agentes e fornecerá relatório do resultado por e-mail.

Para configurar um cronograma para o seu projeto, você deve entrar em contato com o administrador local e fornecer o
seguinte conjunto de informações:
- Nome do componente (projeto)
- Endereço IP do PLC
- Informações sobre quem deve receber notificações por e-mail após a execução do trabalho.

Se você tiver requisitos especiais em relação à configuração da frequência de execução de um trabalho ou às configurações do
comparador (o que deve ser comparado), discuta as opções possíveis com o GroupAdmin. Caso contrário, uma configuração ideal
padrão será usada.

8.2 Verificando os resultados dos Trabalhos

Depois que um trabalho é executado, os resultados são inseridos no banco de dados versiondog. Você também receberá um e-mail
com um resumo do resultado se o GroupAdmin tiver configurado isso para você.

O resultado da última comparação entre a versão do servidor e o projeto PLC é exibido no resumo do projeto:

Figura 41 Servidor<->Estado do dispositivo

Você tem acesso aos backups na seção Backup :

Figura 42 Guia de backup

Ao selecionar um projeto, você verá uma lista de backups armazenados:

Figura 43 Lista de backups