C-Gate IoT Hub - Eerste stappen | C-Gate: Industrie 4.0 ingeschakeld

De C-Gate IoT Hub wordt geleverd als software in een containerformaat. Het wordt aanbevolen om de C-Gate IoT Hub op een centrale server per bedrijfslocatie te installeren. Ook installatie op een standaard PC is mogelijk.

Systeemvereisten

Container runtime-omgeving (bijv. Docker, Kubernetes, OpenShift, Podman, ...)
8 GB RAM
128 GB harde schijfruimte
64-bits processor (4 kernen aanbevolen)
Internetverbinding (tijdens installatie en update)

Indien meer dan 25 regelaars worden aangesloten, kunnen de vereisten groter zijn.

C-Gate IoT Hub Container

De C-Gate IoT Hub container is beschikbaar in de Docker Registry van CLOOS. U ontvangt de nodige toegangsgegevens bij aankoop van een C-Gate IoT Hub .

Register en beeld URL

docker.cloos.de/cgate

Voorbeeld van een testomgeving met Docker

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

Voorbeeld van een productieve omgeving met 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 slaat alle configuraties en gegevens op in de directory /data. Voor deze map moet een volume worden gebruikt om de gegevens te bewaren.

Blootliggende poorten

4840 (OPC UA Server)
5000/tcp (Robotcommunicatie tot V6)
5000/udp (Robotcommunicatie tot V6)
5005 (Robotcommunicatie tot V6)
5010 (Robotcommunicatie tot V6)
5679 (IoT Connector RPC)
8080 (Web Interface)

Variabelen

APP_ADMIN_PASSWORD

Forceert een wachtwoord voor de admin-gebruiker.

Standaardwaarde: Leeg

APP_MAX_DATA_SIZE

Stelt de maximale grootte van de totale door C-Gate opgeslagen gegevens in GB in.

Standaardwaarde: 32

Stap-voor-stap handleiding

Als u nog geen container runtime-omgeving gebruikt, leiden de volgende instructies u door de noodzakelijke stappen voor een basis container runtime-omgeving met C-Gate. In dat geval raden wij u aan u toch vertrouwd te maken met uw containeromgeving om deze veilig te kunnen bedienen.

Installeer Docker voor uw Linux-distributie.

Voer de volgende commando's uit om C-Gate te installeren en te starten:

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
# Voer hier de toegangsgegevens in die u van CLOOS hebt ontvangen.
sudo docker compose up -d
# Geef de toepassing een paar seconden om te starten.
# Lees het gegenereerde wachtwoord voor de gebruiker admin met het volgende commando:
sudo docker logs cgate | grep UserInitializer

Wij raden een installatie onder een Linux-besturingssysteem aan, omdat containers daar al enkele jaren zijn ingeburgerd. Onder Windows daarentegen zijn containers momenteel nog nieuw. U moet dus rekening houden met frequentere wijzigingen, een iets hoger verbruik van middelen en meer uitdagingen tijdens de installatie en de werking.

Zorg ervoor dat de laatste update voor Windows is geïnstalleerd. Je hebt minimaal Windows 10 nodig vanaf versienummer 2004 (Build 19041) of Windows 11.

Om de Windows-versie weer te geven, kan het volgende commando op de opdrachtregel worden uitgevoerd:
```
winver
```

Installeer WSL (Windows Subsystem for Linux) met de volgende commando's op de opdrachtregel:

wsl --set-default-version 2
# Kies hieronder een willekeurige gebruikersnaam en wachtwoord.
# Het is niet nodig hier de CLOOS-toegangsgegevens in te voeren.
wsl --install -d Ubuntu
wsl --set-default Ubuntu

Installeer C-Gate met ons C-Gate IoT Hub installatieprogramma voor Windows.

Na de installatie

De volgende stappen en verdere informatie zijn te vinden op de C-Gate webinterface. Deze is na de installatie toegankelijk via http://localhost op uw server of PC.

Vanaf een andere computer kunt u C-Gate bereiken via http://[serverip], waarbij [serverip] moet worden vervangen door het IP van uw server of PC waarop C-Gate is geïnstalleerd.

Veelgestelde vragen

Waar worden mijn C-Gate gegevens opgeslagen?

Onder Docker worden gegevens meestal opgeslagen in zogenaamde volumes. C-Gate gebruikt zo'n volume voor de interne directory /data.

Hoe kan ik een back-up maken van mijn C-Gate gegevens?

U kunt een back-up van uw gegevens maken met het volgende commando. De back-up wordt opgeslagen in de map waar het commando wordt uitgevoerd.

Linux (Docker):

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

# Back-up herstellen
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):

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

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

Voor een dagelijkse back-up kan bijvoorbeeld een cron job (Linux) of een scheduled task (Windows) worden gebruikt.

Voor een consistente back-up wordt aanbevolen de toepassing kort te stoppen (docker stop cgate) en na de back-up weer te starten (docker start cgate).

C-Gate vraagt me om toegangsgegevens als ik het opstart. Wat moet ik daar invoeren?

Standaard wordt een gebruiker met de naam admin aangemaakt wanneer C-Gate wordt geïnstalleerd. Het wachtwoord voor deze gebruiker wordt gegenereerd de eerste keer dat de Docker Container wordt gestart en uitgevoerd op de opdrachtregel. U kunt de uitvoer van de Docker Container weergeven met het commando docker logs cgate. Het volgende commando geeft u de uitvoer van het genereren van het wachtwoord:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

Bij de Windows installatie worden de toegangsgegevens ook eenmalig getoond aan het einde van de installatie.

Hoe kan ik mijn wachtwoord opnieuw instellen?

U kunt een nieuw beheerderswachtwoord afdwingen door de omgevingsvariabele APP_ADMIN_PASSWORD='NewPassword' in te stellen voor uw C-Gate container. Voor een Docker-installatie met Docker Compose, bijvoorbeeld, kunt u deze variabele instellen in het bestand docker-compose.yml onder de regel environment.

Voorbeeld:

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

Als u C-Gate heeft geïnstalleerd met onze Windows instructies, kunt u het wachtwoord instellen in het bestand ~/.config/cgate/cgate.conf binnen de WSL door de volgende regel in te voeren:

APP_ADMIN_PASSWORD="MySecretPassword"

Hoe sluit ik mijn apparaten aan op C-Gate?

Allereerst moet er een fysieke verbinding beschikbaar zijn. Voor CLOOS-robotsystemen is dit meestal een netwerkkabel die is aangesloten op de robotcontroller en uw bedrijfsnetwerk. QINEO lasapparaten kunnen ook via Wifi worden aangesloten.
Vervolgens hebben uw apparaten een IP-adres en bijbehorende netwerkinstellingen nodig, zodat ze bereikbaar zijn vanaf de server of pc waarop C-Gate IoT Hub is geïnstalleerd. Raadpleeg de handleiding van het betreffende apparaat voor informatie over het aanpassen van de netwerkinstellingen. De netwerkinstellingen moeten worden toegewezen volgens uw IT-beleid. U kunt de verbinding controleren door een ping uit te voeren op het IP van het apparaat vanaf de server of PC met behulp van C-Gate.
Volg de C-Gate instructies op de C-Gate webinterface om uw licentie te activeren. Vervolgens kunt u uw apparaten configureren in de apparaatweergave op C-Gate. Voer daar de overeenkomstige IP-adressen van de apparaten in.

Als alles correct is ingesteld, verschijnen de apparaten als online in de apparaatweergave C-Gate.

Als u nog steeds geen verbinding kunt maken, raadpleeg dan onze opmerkingen over firewallregels.

Welke firewall regels en poorten moeten in acht worden genomen?

De volgende poorten zijn relevant voor toegang tot de C-Gate IoT Hub :

Inkomend	80	TCP	Webinterface en API
Inkomend	4840	TCP	OPC UA server voor de aansluiting van uw MES- en ERP-systemen
Inkomend	5679	TCP	RPC-interface voor de C-Gate IoT Connector

Zonder IoT Connector maakt de C-Gate IoT Hub bovendien verbindingen met de volgende poorten:

Uitgaand	48010	TCP	Robot systemen
Uitgaand	52341	TCP	Lasapparatuur
Uitgaand	4840	TCP	PLC's

Met QIROX Legacy Hardware (hardware ouder dan V7) worden de volgende extra poorten gebruikt:

Inkomend	5000	TCP
Inkomend	5000	UDP
Inkomend	5005	TCP
Inkomend	5010	TCP

Hoe kan ik C-Gate IoT Hub bijwerken?

C-Gate kan worden bijgewerkt met een nieuw container image.

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:

In het Startmenu onder de map C-Gate staat een update-script dat een update uitvoert naar de huidige stabiele versie.

Bestaande gegevens worden door de toepassing automatisch gemigreerd wanneer ze worden bijgewerkt. Afhankelijk van de hoeveelheid gegevens kan het migratieproces de start van de nieuwe applicatieversie met enkele minuten vertragen. De applicatie is gedurende deze tijd niet beschikbaar.

Wat zit er in de C-Gate container?

De C-Gate IoT Hub container is gebaseerd op een actuele officiële Ubuntu basisafbeelding en bevat de volgende diensten. Alleen diensten met een overeenkomstige poortspecificatie zijn toegankelijk van buiten de container. Diensten zonder poortspecificaties zijn alleen toegankelijk binnen de container en zijn daarom beschermd tegen externe toegang.

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

Waarom blokkeert Windows de uitvoering van de C-Gate installatie?

Gedownloade .exe-bestanden worden door Windows gemakkelijk geclassificeerd als een bedreiging. Het volgende Powershell commando kan worden gebruikt om deze classificatie van het bestand te corrigeren:

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

Als de installatie of uitvoering van meegeleverde scriptbestanden nog steeds wordt geblokkeerd, installeer dan ons Cloos-certificaat in uw systeem en probeer het opnieuw. Zorg ervoor dat u tijdens de installatie "Trusted Root Certification Authorities" selecteert als locatie voor het certificaat.

Ik heb C-Gate handmatig geïnstalleerd op Windows met behulp van Docker Desktop. Hoe migreer ik mijn gegevens naar de nieuwe versie met het C-Gate installatieprogramma?

Het nieuwe C-Gate installatieprogramma voor Windows detecteert automatisch een eerdere installatie met Docker Desktop en importeert de gegevens tijdens de installatie. Controleer na de installatie of uw C-Gate installatie gewoon werkt. Verwijder daarna de C-Gate container uit Docker Desktop zodat deze niet automatisch opnieuw start na een reboot.

De update van mijn C-Gate installatie onder Windows meldt een fout met toegangsgegevens. Hoe kan ik dit oplossen?

Bij een oudere C-Gate installatie onder Windows werden de toegangsgegevens tot de CLOOS Docker Repository gedeeltelijk niet permanent opgeslagen. Om het probleem op te lossen, voert u het volgende commando uit in uw WSL-installatie (Ubuntu) en voert u de toegangsgegevens in die u bij uw C-Gate licentie hebt ontvangen:

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