C-Gate IoT Hub - Pierwsze kroki | C-Gate: Przemysł 4.0

Serwis C-Gate IoT Hub jest udostępniany jako oprogramowanie w formacie kontenera. Zaleca się instalację C-Gate IoT Hub na centralnym serwerze w każdej lokalizacji firmy. Alternatywnie możliwa jest również instalacja na standardowym komputerze PC.

Wymagania systemowe

Środowisko uruchomieniowe kontenerów (np. Docker, Kubernetes, OpenShift, Podman, ...)
8 GB RAM
128 GB miejsca na dysku twardym
Procesor 64-bitowy (zalecane 4 rdzenie)
Połączenie z Internetem (podczas instalacji i aktualizacji)

Jeśli podłączonych jest więcej niż 25 sterowników, wymagania mogą być większe.

C-Gate IoT Hub Kontener

Kontener C-Gate IoT Hub jest udostępniany w Docker Registry przez CLOOS. Niezbędne dane dostępowe otrzymacie Państwo przy zakupie strony C-Gate IoT Hub .

Rejestr i adres URL obrazu

docker.cloos.de/cgate

Przykład środowiska testowego z Dockerem

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

Przykład produktywnego środowiska z 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:

Tomy

C-Gate przechowuje wszystkie konfiguracje i dane w katalogu /data. Dla tego katalogu powinien być użyty wolumin, który będzie utrzymywał dane.

Odsłonięte porty

4840 (OPC UA Server)
5000/tcp (Komunikacja robotów do V6)
5000/udp (Komunikacja robotów do V6)
5005 (Komunikacja robotów do V6)
5010 (Komunikacja robotów do V6)
5679 (IoT Connector RPC)
8080 (Web Interface)

Zmienne

APP_ADMIN_PASSWORD

Wymusza hasło dla użytkownika admin.

Wartość domyślna: Puste

APP_MAX_DATA_SIZE

Ustawia maksymalny rozmiar całkowitych danych przechowywanych przez C-Gate w GB.

Wartość domyślna: 32

Przewodnik krok po kroku

Jeśli nie używasz jeszcze środowiska uruchomieniowego kontenera, poniższe instrukcje poprowadzą Cię przez niezbędne kroki dla podstawowego środowiska uruchomieniowego kontenera z C-Gate. W takim przypadku zalecamy, aby mimo wszystko zapoznać się ze środowiskiem kontenera, aby móc go bezpiecznie obsługiwać.

Zainstaluj Dockera dla swojej dystrybucji Linuksa.

Wykonaj następujące polecenia, aby zainstalować i uruchomić stronę 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
# Wpisz tutaj dane dostępowe, które otrzymałeś od CLOOS.
sudo docker compose up -d
# Daj aplikacji kilka sekund na uruchomienie.
# Odczytaj wygenerowane hasło dla użytkownika admin za pomocą następującego polecenia:
sudo docker logs cgate | grep UserInitializer

Zalecamy instalację pod systemem operacyjnym Linux, ponieważ kontenery są już tam zadomowione od kilku lat. Z kolei pod Windowsem kontenery są obecnie wciąż nowością. Należy więc spodziewać się częstszych zmian, nieco większego zużycia zasobów i większych wyzwań podczas konfiguracji i eksploatacji.

Upewnij się, że zainstalowana jest najnowsza aktualizacja dla systemu Windows. Potrzebny jest co najmniej Windows 10 z numeru wersji 2004 (Build 19041) lub Windows 11.

Aby wyświetlić wersję systemu Windows, można wykonać następujące polecenie w wierszu poleceń:
```
winver
```

Zainstaluj WSL (Windows Subsystem for Linux) za pomocą następujących poleceń w wierszu poleceń:

wsl --set-default-version 2
# W dalszej części należy wybrać dowolną nazwę użytkownika i hasło.
# Nie jest konieczne wprowadzanie tutaj danych dostępowych CLOOS.
wsl --install -d Ubuntu
wsl --set-default Ubuntu

Zainstaluj C-Gate za pomocą naszego C-Gate IoT Hub instalatora dla Windows.

Po instalacji

Kolejne kroki i dalsze informacje można znaleźć w interfejsie internetowym C-Gate. Dostęp do niego można uzyskać po instalacji pod adresem http://localhost na serwerze lub komputerze.

Z innego komputera można dotrzeć do C-Gate pod adresem http://[serverip], gdzie [serverip] należy zastąpić IP serwera lub komputera, na którym zainstalowano C-Gate.

Najczęściej zadawane pytania

Gdzie są przechowywane moje dane C-Gate?

W systemie Docker dane są zwykle przechowywane w tzw. woluminach. C-Gate używa takiego woluminu dla wewnętrznego katalogu /data.

Jak mogę utworzyć kopię zapasową moich danych C-Gate?

Możesz utworzyć kopię zapasową swoich danych za pomocą następującego polecenia. Kopia zapasowa jest przechowywana w folderze, w którym zostało wykonane polecenie.

Linux (Docker):

# Utwórz kopię zapasową
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Przywróć kopię zapasową
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):

# Utwórz kopię zapasową
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Przywróć kopię zapasową
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Do codziennego tworzenia kopii zapasowych można użyć na przykład zadania cron (Linux) lub zadania zaplanowanego (Windows).

W celu uzyskania spójnego backupu zaleca się krótkie zatrzymanie aplikacji (docker stop cgate) i ponowne jej uruchomienie po wykonaniu backupu (docker start cgate).

C-Gate pyta mnie o dane dostępu, gdy go uruchamiam. Co mam tam wpisać?

Domyślnie, użytkownik o nazwie admin jest tworzony podczas instalacji C-Gate. Hasło dla tego użytkownika jest generowane przy pierwszym uruchomieniu Docker Container i wyprowadzane w wierszu poleceń. Możesz wyświetlić dane wyjściowe kontenera Docker Container za pomocą polecenia docker logs cgate. Poniższe polecenie przedstawia dane wyjściowe dotyczące generowania hasła:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

W przypadku instalacji w systemie Windows dane dostępu są również wyświetlane raz na koniec instalacji.

Jak mogę zresetować swoje hasło?

Możesz wymusić nowe hasło administratora, ustawiając zmienną środowiskową APP_ADMIN_PASSWORD='NewPassword' dla swojego kontenera C-Gate. Na przykład dla instalacji Docker z Docker Compose możesz ustawić tę zmienną w pliku docker-compose.yml poniżej linii environment.

Przykład:

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

Jeśli zainstalowałeś C-Gate za pomocą naszej instrukcji dla systemu Windows, możesz ustawić hasło w pliku ~/.config/cgate/cgate.conf w ramach WSL, wprowadzając następującą linię:

APP_ADMIN_PASSWORD="MySecretPassword"

Jak podłączyć moje urządzenia do C-Gate?

Przede wszystkim powinno być dostępne fizyczne połączenie. W przypadku systemów robotów CLOOS jest to zazwyczaj kabel sieciowy podłączony do kontrolera robota i sieci firmowej. Urządzenia spawalnicze QINEO mogą być alternatywnie połączone przez Wifi.
Następnie urządzenia potrzebują adresu IP i odpowiednich ustawień sieciowych, aby można je było osiągnąć z serwera lub komputera, na którym zainstalowana jest strona C-Gate IoT Hub . Informacje na temat dostosowania ustawień sieciowych znajdują się w instrukcji obsługi odpowiedniego urządzenia. Ustawienia sieciowe powinny być przypisane zgodnie z polityką IT. Połączenie można sprawdzić uruchamiając ping na IP urządzenia z serwera lub komputera za pomocą C-Gate.
Postępuj zgodnie z instrukcjami C-Gate w interfejsie internetowym C-Gate, aby aktywować licencję. Następnie możesz skonfigurować swoje urządzenia w widoku urządzenia na stronie C-Gate. Wprowadzić tam odpowiednie adresy IP urządzeń.

Jeśli wszystko jest skonfigurowane prawidłowo, urządzenia pojawiają się jako online w widoku urządzeń C-Gate.

Jeśli nadal nie możesz się połączyć, zapoznaj się z naszymi uwagami dotyczącymi reguł zapory sieciowej.

Które reguły zapory i porty muszą być przestrzegane?

Następujące porty są istotne dla dostępu do strony C-Gate IoT Hub :

Przychodzące	80	TCP	Interfejs internetowy i API
Przychodzące	4840	TCP	Serwer OPC UA do podłączenia systemów MES i ERP
Przychodzące	5679	TCP	Interfejs RPC dla strony C-Gate IoT Connector

Bez IoT Connector, C-Gate IoT Hub dodatkowo nawiązuje połączenia z następującymi portami:

Wychodzące	48010	TCP	Systemy robotów
Wychodzące	52341	TCP	Urządzenia do spawania
Wychodzące	4840	TCP	PLC

Z QIROX Legacy Hardware (sprzęt starszy niż V7) używane są następujące dodatkowe porty:

Przychodzące	5000	TCP
Przychodzące	5000	UDP
Przychodzące	5005	TCP
Przychodzące	5010	TCP

Jak mogę zaktualizować stronę C-Gate IoT Hub ?

C-Gate można uaktualnić za pomocą nowego obrazu kontenera.

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:

W menu Start pod folderem C-Gate znajduje się skrypt aktualizacyjny, który wykonuje aktualizację do aktualnej stabilnej wersji.

Istniejące dane są automatycznie migrowane przez aplikację podczas ich aktualizacji. W zależności od ilości danych, proces migracji może opóźnić start nowej wersji aplikacji o kilka minut. W tym czasie aplikacja nie jest dostępna.

Co znajduje się wewnątrz pojemnika C-Gate?

Kontener C-Gate IoT Hub jest oparty na aktualnym oficjalnym obrazie bazowym Ubuntu i zawiera następujące usługi. Tylko usługi z odpowiednią specyfikacją portu mogą być dostępne z zewnątrz kontenera. Dostęp do usług bez specyfikacji portu jest możliwy tylko w obrębie kontenera i dlatego są one chronione przed dostępem z zewnątrz.

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

Dlaczego system Windows blokuje wykonanie instalacji C-Gate?

Pobrane pliki .exe są łatwo klasyfikowane przez system Windows jako zagrożenie. Następujące polecenie Powershell może być użyte do poprawienia tej klasyfikacji dla pliku:

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

Jeśli instalacja lub wykonanie dołączonych plików skryptów nadal jest zablokowane, proszę zainstalować nasz certyfikat Cloos w swoim systemie i spróbować ponownie. Należy pamiętać, aby podczas instalacji wybrać "Trusted Root Certification Authorities" jako lokalizację dla certyfikatu.

Ręcznie zainstalowałem C-Gate w systemie Windows za pomocą Docker Desktop. Jak zmigrować dane do nowej wersji za pomocą instalatora C-Gate?

Nowy instalator C-Gate dla Windows automatycznie wykrywa poprzednią instalację z Docker Desktop i importuje dane podczas instalacji. Po instalacji upewnij się, że Twoja instalacja C-Gate działa jak zwykle. Następnie należy usunąć kontener C-Gate z Docker Desktop, aby nie uruchamiał się on ponownie automatycznie po ponownym uruchomieniu.

Aktualizacja mojej instalacji C-Gate pod Windowsem zgłasza błąd z danymi dostępowymi. Jak mogę to naprawić?

Przy starszej instalacji C-Gate pod Windowsem dane dostępu do CLOOS Docker Repository częściowo nie były trwale zapisane. Aby naprawić problem, wykonaj poniższe polecenie w swojej instalacji WSL (Ubuntu) i wprowadź dane dostępowe, które otrzymałeś wraz z licencją C-Gate:

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