C-Gate IoT Hub - Primeiros passos | C-Gate: Indústria 4.0 habilitada

O C-Gate IoT Hub é fornecido como um software em formato de container. É recomendável instalar o C-Gate IoT Hub em um servidor central por localização da empresa. Alternativamente, a instalação em um PC padrão também é possível.

Requisitos do sistema

Ambiente de funcionamento do contêiner (por exemplo, Docker, Kubernetes, OpenShift, Podman, ...)
8 GB DE RAM
128 GB de espaço em disco rígido
Processador de 64 bits (4 núcleos recomendados)
Conexão à Internet (durante a instalação e atualização)

Se mais de 25 controladores estiverem conectados, os requisitos podem ser maiores.

C-Gate IoT Hub Container

O container C-Gate IoT Hub é fornecido no Registro de Docker pela CLOOS. Você receberá os dados de acesso necessários quando comprar um C-Gate IoT Hub .

Registro e URL da imagem

docker.cloos.de/cgate

Exemplo de um ambiente de teste com Docker

docker run -d --name cgate -p 80:8080 -p 4840:4840 docker.cloos.de/cgate

Exemplo de um ambiente produtivo com Docker Compose

version: "3"
services:
  cgate:
    container_name: cgate
    image: docker.cloos.de/cgate:latest
    restart: always
    ports:
      - "80:8080"
      - "4840:4840"
      - "5000:5000/tcp"
      - "5000:5000/udp"
      - "5005:5005"
      - "5010:5010"
      - "5679:5679"
    environment:
      - APP_MAX_DATA_SIZE_GB=64
    volumes:
      - data:/data
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
volumes:
  data:

Volumes

C-Gate armazena todas as configurações e dados no diretório /data. Um volume deve ser usado para que este diretório persista com os dados.

Portos expostos

4840 (OPC UA Server)
5000/tcp (Comunicação por robô até V6)
5000/udp (Comunicação por robô até V6)
5005 (Comunicação por robô até V6)
5010 (Comunicação por robô até V6)
5679 (IoT Connector RPC)
8080 (Web Interface)

Variáveis

APP_ADMIN_PASSWORD

Força uma senha para o usuário administrador.

Valor padrão: Vazio

APP_MAX_DATA_SIZE

Define o tamanho máximo do total de dados armazenados por C-Gate em GB.

Valor padrão: 32

Guia passo a passo

Se você ainda não estiver usando um ambiente de tempo de funcionamento de contêineres, as seguintes instruções o guiarão através das etapas necessárias para um ambiente de tempo de funcionamento básico de contêineres com C-Gate. Neste caso, recomendamos que você, mesmo assim, se adapte ao ambiente de seu container para poder operá-lo com segurança.

Instale o Docker para sua distribuição Linux.

Execute os seguintes comandos para instalar e iniciar C-Gate:

sudo mkdir -p /opt/cloos/cgate
cd /opt/cloos/cgate/
sudo curl -L https://c-gate.cloos.de/static/install/docker-compose.yml -o docker-compose.yml
sudo docker login docker.cloos.de
# Digite aqui os dados de acesso que você recebeu da CLOOS.
sudo docker compose up -d
# Dê alguns segundos para o início da aplicação.
# Leia a senha gerada para o usuário admin com o seguinte comando:
sudo docker logs cgate | grep UserInitializer

Recomendamos uma instalação sob um sistema operacional Linux, uma vez que os containers já foram estabelecidos lá há vários anos. Sob o Windows, por outro lado, os recipientes ainda são atualmente novos. Portanto, você deve esperar mudanças mais freqüentes, consumo de recursos ligeiramente maior e mais desafios durante a instalação e operação.

Assegure-se de que a última atualização para Windows esteja instalada. Você precisa pelo menos do Windows 10 da versão número 2004 (Build 19041) ou do Windows 11.

Para exibir a versão Windows, o seguinte comando pode ser executado na linha de comando:
```
winver
```

Instalar WSL (Windows Subsystem for Linux) com os seguintes comandos na linha de comando:

wsl --set-default-version 2
# A seguir, selecione qualquer nome de usuário e senha.
# Não é necessário inserir aqui os dados de acesso à CLOOS.
wsl --install -d Ubuntu
wsl --set-default Ubuntu

Instalar C-Gate com nosso instaladorC-Gate IoT Hub para Windows.

Após a instalação

As próximas etapas e outras informações podem ser encontradas na interface web C-Gate. Você pode acessá-lo após a instalação em http://localhost em seu servidor ou PC.

De outro computador você pode acessar C-Gate em http://[serverip], onde [serverip] deve ser substituído pelo IP de seu servidor ou PC no qual C-Gate foi instalado.

Perguntas mais freqüentes

Onde meus dados C-Gate estão armazenados?

Sob Docker, os dados são normalmente armazenados nos chamados volumes. C-Gate usa um desses volumes para o diretório interno /data.

Como posso criar um backup dos meus dados C-Gate?

Você pode criar um backup de seus dados com o seguinte comando. O backup é armazenado na pasta onde o comando é executado.

Linux (Docker):

# Criar backup
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Restaurar o backup
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Windows (WSL Ubuntu Shell):

# Criar backup
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Restaurar o backup
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Para um backup diário, por exemplo, um cron job (Linux) ou uma tarefa agendada (Windows) pode ser usado.

Para um backup consistente, recomenda-se parar brevemente a aplicação (docker stop cgate) e reiniciá-la após o backup (docker start cgate).

C-Gate me pede dados de acesso quando eu os inicio. O que eu tenho que entrar lá?

Por padrão, um usuário com o nome admin é criado quando C-Gate é instalado. A senha para este usuário é gerada na primeira vez que o Docker Container é iniciado e emitido na linha de comando. Você pode exibir a saída do Docker Container com o comando docker logs cgate. O comando a seguir fornece a saída da geração da senha:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

Com a instalação do Windows, os dados de acesso também são exibidos uma vez no final da instalação.

Como posso redefinir minha senha?

Você pode forçar uma nova senha de administração definindo a variável de ambiente APP_ADMIN_PASSWORD='NewPassword' para seu recipiente C-Gate. Para uma instalação de Docker com Docker Compose, por exemplo, você pode definir esta variável no arquivo docker-compose.yml abaixo da linha environment.

Exemplo:

...
  environment:
    - APP_ADMIN_PASSWORD="MySecretPassword"
...

Se você instalou C-Gate com nossas instruções do Windows, você pode definir a senha no arquivo ~/.config/cgate/cgate.conf dentro da WSL, digitando a seguinte linha:

APP_ADMIN_PASSWORD="MySecretPassword"

Como eu conecto meus dispositivos a C-Gate?

Antes de mais nada, uma conexão física deve estar disponível. Para os sistemas de robôs CLOOS, este é geralmente um cabo de rede conectado ao controlador do robô e à rede de sua empresa. As unidades de solda QINEO podem, alternativamente, ser conectadas via Wifi.
Então seus dispositivos precisam de um endereço IP e configurações de rede correspondentes para que possam ser alcançados a partir do servidor ou PC no qual C-Gate IoT Hub está instalado. Consulte o respectivo manual do dispositivo para obter informações sobre como ajustar as configurações da rede. As configurações da rede devem ser atribuídas de acordo com sua política de TI. Você pode verificar a conexão executando um ping no IP do dispositivo a partir do servidor ou PC usando C-Gate.
Siga as instruções C-Gate na interface web C-Gate para ativar sua licença. Você pode então configurar seus dispositivos na visualização do dispositivo em C-Gate. Digite ali os endereços IP correspondentes dos dispositivos.

Se tudo estiver configurado corretamente, os dispositivos aparecem como on-line na visualização do dispositivo C-Gate.

Se você ainda não conseguir se conectar, consulte nossas notas sobre regras de firewall.

Quais regras e portas de firewall devem ser observadas?

Os seguintes portos são relevantes para o acesso ao C-Gate IoT Hub :

Entrada	80	TCP	Interface Web e API
Entrada	4840	TCP	Servidor OPC UA para a conexão de seus sistemas MES e ERP
Entrada	5679	TCP	Interface RPC para o C-Gate IoT Connector

Sem IoT Connector, o C-Gate IoT Hub estabelece adicionalmente conexões com os seguintes portos:

Saída	48010	TCP	Sistemas de robôs
Saída	52341	TCP	Equipamento de soldagem
Saída	4840	TCP	CLPs

Com o QIROX Legacy Hardware (hardware mais antigo que V7) são utilizadas as seguintes portas adicionais:

Entrada	5000	TCP
Entrada	5000	UDP
Entrada	5005	TCP
Entrada	5010	TCP

Como posso atualizar C-Gate IoT Hub ?

C-Gate pode ser atualizado com uma nova imagem do contêiner.

Linux (Docker):

cd /opt/cloos/cgate/
docker compose pull
docker compose up -d

Linux (Docker-Compose):

cd /opt/cloos/cgate/
docker-compose pull
docker-compose up -d

Windows:

No menu Iniciar sob a pasta C-Gate há um script de atualização que realiza uma atualização para a versão estável atual.

Os dados existentes são migrados automaticamente pela aplicação quando são atualizados. Dependendo da quantidade de dados, o processo de migração pode atrasar o início da nova versão do aplicativo em alguns minutos. A aplicação não está disponível durante este tempo.

O que está dentro do contêiner C-Gate?

O contêiner C-Gate IoT Hub é baseado em uma imagem oficial atual da base Ubuntu e contém os seguintes serviços. Somente serviços com uma especificação portuária correspondente podem ser acessados do exterior do contêiner. Serviços sem especificações portuárias só podem ser acessados dentro do contêiner e, portanto, são protegidos do acesso externo.

C-Gate IoT Hub Java Application (Port 4840/tcp, 5000/tcp/udp, 5005/tcp, 5010/tcp)
C-Gate IoT Hub NodeJS Graph-Converter Service
nginx Webserver (Port 8080/tcp)
mongoDB Database

Por que o Windows bloqueia a execução da instalação C-Gate?

Os arquivos .exe baixados são facilmente classificados como uma ameaça pelo Windows. O seguinte comando Powershell pode ser usado para corrigir esta classificação para o arquivo:

cd Downloads
Unblock-File -Confirm:$false '.\C-Gate IoT Hub Setup.exe'

Se a instalação ou execução dos arquivos de roteiro incluídos ainda estiver bloqueada, por favor, instale nosso certificado Cloos em seu sistema e tente novamente. Certifique-se de selecionar "Trusted Root Certification Authorities" como o local para o certificado durante a instalação.

Instalei manualmente C-Gate no Windows usando o Docker Desktop. Como migrar meus dados para a nova versão com o instalador C-Gate?

O novo instalador C-Gate para Windows detecta automaticamente uma instalação anterior com Docker Desktop e importa os dados durante a instalação. Após a instalação, certifique-se de que sua instalação C-Gate funcione como de costume. Em seguida, por favor, exclua o container C-Gate do Docker Desktop para que ele não recomece automaticamente após uma reinicialização.

A atualização de minha instalação C-Gate sob Windows relata um erro com os dados de acesso. Como posso consertar isso?

Com uma instalação mais antiga C-Gate sob Windows, os dados de acesso ao CLOOS Docker Repository não foram armazenados em parte permanentemente. Para resolver o problema, execute o seguinte comando em sua instalação WSL (Ubuntu) e digite os dados de acesso que você recebeu com sua licença C-Gate:

podman login --authfile=${HOME}/.docker/config.json docker.cloos.de