C-Gate IoT Hub - Első lépések | C-Gate: Ipar 4.0-képes

A C-Gate IoT Hub szoftverként, konténer formátumban kerül rendelkezésre bocsátásra. Ajánlott a C-Gate IoT Hub egy központi szerverre telepíteni vállalati telephelyenként. Alternatív megoldásként a telepítés egy hagyományos PC-re is lehetséges.

Rendszerkövetelmények

Konténer futtatókörnyezet (pl. Docker, Kubernetes, OpenShift, Podman, ...)
8 GB RAM
128 GB tárhely a merevlemezen
64 bites processzor (4 mag ajánlott)
Internetkapcsolat (a telepítés és frissítés során)

Ha 25-nél több vezérlő van csatlakoztatva, a követelmények nagyobbak lehetnek.

C-Gate IoT Hub Konténer

A C-Gate IoT Hub konténert a CLOOS biztosítja a Docker Registryben. A C-Gate IoT Hub megvásárlásakor megkapja a szükséges hozzáférési adatokat.

Nyilvántartás és kép URL

docker.cloos.de/cgate

Példa egy tesztkörnyezetre Dockerrel

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

Példa egy produktív környezetre a Docker Compose-szal

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:

Kötetek

C-Gate az összes konfigurációt és adatot a /data könyvtárban tárolja. Ehhez a könyvtárhoz egy kötetet kell használni az adatok tárolásához.

Kitett portok

4840 (OPC UA Server)
5000/tcp (Robotkommunikáció V6-ig)
5000/udp (Robotkommunikáció V6-ig)
5005 (Robotkommunikáció V6-ig)
5010 (Robotkommunikáció V6-ig)
5679 (IoT Connector RPC)
8080 (Web Interface)

Változók

APP_ADMIN_PASSWORD

Kényszeríti az admin felhasználó jelszavát.

Alapértelmezett érték: Üres

APP_MAX_DATA_SIZE

Beállítja a C-Gate által tárolt összes adat maximális méretét GB-ban.

Alapértelmezett érték: 32

Lépésről lépésre útmutató

Ha még nem használ konténer-futtatókörnyezetet, a következő utasítások végigvezetik a C-Gate segítségével egy alap konténer-futtatókörnyezet létrehozásához szükséges lépéseken. Ebben az esetben javasoljuk, hogy ennek ellenére ismerkedjen meg a konténer-környezetével, hogy biztonságosan tudja üzemeltetni azt.

Telepítse a Dockert a Linux disztribúciójához.

A C-Gate telepítéséhez és indításához hajtsa végre a következő parancsokat:

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
# Itt adja meg a CLOOS-tól kapott hozzáférési adatokat.
sudo docker compose up -d
# Adjon az alkalmazásnak néhány másodpercet az induláshoz.
# Olvassa ki a admin felhasználó generált jelszavát a következő paranccsal:
sudo docker logs cgate | grep UserInitializer

Javasoljuk a Linux operációs rendszer alatti telepítést, mivel a konténerek már évek óta ott vannak jelen. Windows alatt viszont a konténerek jelenleg még újdonságnak számítanak. Ezért gyakoribb változtatásokra, valamivel nagyobb erőforrás-fogyasztásra és több kihívásra kell számítani a telepítés és a működés során.

Győződjön meg róla, hogy a Windows legújabb frissítése telepítve van. Legalább Windows 10-re van szüksége a 2004 (Build 19041) vagy Windows 11 verziószámtól.

A Windows-verzió megjelenítéséhez a parancssorban a következő parancsot lehet végrehajtani:
```
winver
```

Telepítse a WSL-t (Windows Subsystem for Linux) a következő parancsokkal a parancssorban:

wsl --set-default-version 2
# A következőkben válasszon ki egy tetszőleges felhasználónevet és jelszót.
# Itt nem szükséges megadni a CLOOS hozzáférési adatokat.
wsl --install -d Ubuntu
wsl --set-default Ubuntu

Telepítse a C-Gate a C-Gate IoT Hub Windows telepítőnkkel.

A telepítés után

A következő lépések és további információk a C-Gate webes felületen találhatók. Ezt a telepítés után a http://localhost címen érheti el szerverén vagy számítógépén.

Egy másik számítógépről a C-Gate címen érhető el: http://[serverip], ahol a [serverip] helyett a szerver vagy a számítógép IP-címét kell megadni, amelyre a C-Gate van telepítve.

Gyakran ismételt kérdések

Hol tárolják a C-Gate adataimat?

A Docker alatt az adatokat általában úgynevezett kötetekben tárolják. A C-Gate egy ilyen kötetet használ a /data belső könyvtárhoz.

Hogyan készíthetek biztonsági másolatot a C-Gate adataimról?

A következő paranccsal készíthet biztonsági mentést az adatokról. A biztonsági mentés abban a mappában tárolódik, ahol a parancsot végrehajtotta.

Linux (Docker):

# Biztonsági mentés létrehozása
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Biztonsági mentés visszaállítása
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):

# Biztonsági mentés létrehozása
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Biztonsági mentés visszaállítása
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

A napi mentéshez például egy cron feladat (Linux) vagy egy ütemezett feladat (Windows) használható.

A konzisztens biztonsági mentés érdekében ajánlott az alkalmazást rövid időre leállítani (docker stop cgate) és a biztonsági mentés után újraindítani (docker start cgate).

C-Gate elindításakor hozzáférési adatokat kér tőlem. Mit kell ott megadnom?

Alapértelmezés szerint a C-Gate telepítésekor létrejön egy admin nevű felhasználó. Ennek a felhasználónak a jelszava a Docker Container első indításakor generálódik, és a parancssorban kerül kiadásra. A Docker Container kimenete a docker logs cgate paranccsal jeleníthető meg. A következő parancs a jelszógenerálás kimenetét adja meg:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

A Windows telepítésnél a hozzáférési adatok is megjelennek egyszer a telepítés végén.

Hogyan állíthatom vissza a jelszavam?

Új admin jelszót kényszeríthet a APP_ADMIN_PASSWORD='NewPassword' környezeti változó beállításával a C-Gate konténerhez. Docker Compose-szal rendelkező Docker telepítés esetén például a docker-compose.yml fájlban a environment sor alatt a alatt állíthatja be ezt a változót.

Példa:

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

Ha a C-Gate oldalt a Windows utasításainkkal telepítette, akkor a jelszót a ~/.config/cgate/cgate.conf fájlban a WSL-en belül a következő sor beírásával állíthatja be.:

APP_ADMIN_PASSWORD="MySecretPassword"

Hogyan csatlakoztathatom az eszközeimet a C-Gate weboldalhoz ?

Először is, fizikai kapcsolatnak kell rendelkezésre állnia. A CLOOS robotrendszerek esetében ez általában egy hálózati kábel, amely a robotvezérlőhöz és a vállalati hálózathoz csatlakozik. A QINEO hegesztőegységek alternatívaként Wifi-n keresztül is csatlakoztathatók.
Ezután az eszközöknek IP-címre és a megfelelő hálózati beállításokra van szükségük, hogy elérhetők legyenek arról a szerverről vagy számítógépről, amelyen a C-Gate IoT Hub van telepítve. A hálózati beállítások beállításával kapcsolatos információkért olvassa el a megfelelő eszköz kézikönyvét. A hálózati beállításokat az Ön informatikai szabályzatának megfelelően kell kijelölni. A kapcsolatot úgy ellenőrizheti, hogy a ping az eszköz IP címét a C-Gate szerverről vagy PC-ről futtatja a segítségével.
A licenc aktiválásához kövesse a C-Gate oldalon található utasításokat a C-Gate webes felületen. Ezt követően a C-Gate oldalon az eszköz nézetben konfigurálhatja eszközeit. Adja meg ott az eszközök megfelelő IP-címét.

Ha minden megfelelően van beállítva, akkor az eszközök a C-Gate eszköznézetben online-ként jelennek meg.

Ha továbbra sem tud csatlakozni, kérjük, olvassa el a tűzfalszabályokról szóló megjegyzéseinket.

Milyen tűzfalszabályokat és portokat kell betartani?

A következő portok a C-Gate IoT Hub eléréséhez szükségesek:

Bejövő	80	TCP	Webes felület és API
Bejövő	4840	TCP	OPC UA szerver a MES és ERP rendszerek összekapcsolásához
Bejövő	5679	TCP	RPC interfész a C-Gate számára IoT Connector

A IoT Connector nélkül a C-Gate IoT Hub ezen felül a következő portokhoz is kapcsolatot létesít:

Kimenő	48010	TCP	Robotrendszerek
Kimenő	52341	TCP	Hegesztő berendezések
Kimenő	4840	TCP	PLC

A QIROX Legacy Hardware (V7-nél régebbi hardver) esetén a következő további portok használatosak:

Bejövő	5000	TCP
Bejövő	5000	UDP
Bejövő	5005	TCP
Bejövő	5010	TCP

Hogyan tudom frissíteni a C-Gate IoT Hub címet?

C-Gate egy új konténerképpel lehet frissíteni.

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:

A Start menüben a C-Gate mappa alatt található egy frissítő szkript, amely frissítést végez az aktuális stabil verzióra.

A meglévő adatokat az alkalmazás frissítéskor automatikusan átmigrálja. Az adatok mennyiségétől függően a migrációs folyamat néhány perccel késleltetheti az új alkalmazásváltozat indítását. Az alkalmazás ez idő alatt nem érhető el.

Mi van a C-Gate konténerben?

A C-Gate IoT Hub konténer egy aktuális hivatalos Ubuntu alapképen alapul, és a következő szolgáltatásokat tartalmazza. A konténeren kívülről csak a megfelelő portspecifikációval rendelkező szolgáltatások érhetők el. A portspecifikáció nélküli szolgáltatások csak a konténeren belül érhetők el, ezért védve vannak a külső hozzáféréstől.

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

Miért blokkolja a Windows a C-Gate telepítésének végrehajtását?

A letöltött .exe fájlokat a Windows könnyen fenyegetésnek minősíti. A következő Powershell-paranccsal korrigálhatja a fájl besorolását:

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

Ha a telepítés vagy a mellékelt szkriptfájlok végrehajtása továbbra is blokkolva van, kérjük, telepítse a Cloos tanúsítványt a rendszerébe, és próbálja meg újra. Kérjük, győződjön meg róla, hogy a telepítés során a tanúsítvány helyeként a "Megbízható gyökér-tanúsító hatóságok" lehetőséget választja.

Kézzel telepítettem a C-Gate oldalt Windowsra a Docker Desktop segítségével. Hogyan migrálhatom az adataimat az új verzióra a C-Gate telepítővel?

Az új C-Gate Windows telepítő automatikusan felismeri a Docker Desktop korábbi telepítését, és a telepítés során importálja az adatokat. A telepítés után győződjön meg arról, hogy a C-Gate telepítése a megszokott módon működik. Ezt követően kérjük, törölje a C-Gate konténert a Docker Desktopról, hogy az ne induljon újra automatikusan újra egy újraindítás után.

A C-Gate Windows alatti telepítésem frissítése hibát jelez a hozzáférési adatokkal kapcsolatban. Hogyan tudom ezt kijavítani?

A C-Gate régebbi Windows alatti telepítésénél a CLOOS Docker Repository hozzáférési adatai részben nem voltak tartósan tárolva. A probléma kijavításához, kérjük, hajtsa végre a következő parancsot a WSL telepítésében (Ubuntu), és adja meg a C-Gate licencével kapott hozzáférési adatokat:

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