The C-Gate IoT Hub jest dostarczany 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
- Kontenerowe środowisko uruchomieniowe (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)
C-Gate IoT Hub Pojemnik
Kontener C-Gate IoT Hub jest dostarczany w rejestrze Docker przez CLOOS. Przy zakupie C-Gate IoT Hub otrzymają Państwo niezbędne dane dostępowe.
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 środowiska produktywnego 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
volumes:
data:
Tomy
C-Gate przechowuje wszystkie konfiguracje i dane w katalogu /data
. Wolumin powinien być używany dla tego katalogu do przechowywania danych.
Odsłonięte porty
- 4840 (OPC UA Server)
- 5000/tcp (Komunikacja z robotem do V6)
- 5000/udp (Komunikacja z robotem do V6)
- 5005 (Komunikacja z robotem do V6)
- 5010 (Komunikacja z robotem 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 wszystkich danych przechowywanych przez C-Gate w GB.
Wartość domyślna: 32
Przewodnik krok po kroku
Jeżeli nie korzystacie Państwo jeszcze ze środowiska uruchomieniowego kontenera, poniższe instrukcje przeprowadzą Państwa przez niezbędne kroki dla podstawowego środowiska uruchomieniowego kontenera z C-Gate. W tym przypadku zalecamy, abyście Państwo mimo wszystko zapoznali się ze swoim środowiskiem kontenerowym, aby móc je bezpiecznie obsługiwać.
- Zainstaluj Dockera dla swojej dystrybucji Linuksa.
- Zainstaluj Docker Compose.
-
Wykonaj następujące polecenia, aby zainstalować i uruchomić 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ępu, 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ą tam już od kilku lat. Z drugiej strony, w systemie Windows kontenery są obecnie wciąż nowością. Dlatego należy spodziewać się częstszych zmian, nieco większego zużycia zasobów i większych wyzwań podczas konfiguracji i obsługi.
-
Upewnij się, że została zainstalowana najnowsza aktualizacja systemu Windows. Potrzebny jest co najmniej system Windows 10 z numerem 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 wsl --install -d Ubuntu wsl --set-default Ubuntu
- Zainstaluj C-Gate za pomocą naszego instalatora C-Gate IoT Hub dla Windows.
Po instalacji
Kolejne kroki i dalsze informacje można znaleźć na 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 C-Gate został zainstalowany.
Najczęściej zadawane pytania
- Gdzie są przechowywane moje dane C-Gate?
W Dockerze dane są zazwyczaj przechowywane w tzw. wolumenach. 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 zapisywana w folderze, w którym zostało wykonane polecenie.
Linux (Docker):
Windows (WSL Ubuntu Shell):# 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"
# 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 na przykład użyć zadania cron (Linux) lub zaplanowanego zadania (Windows).
W celu uzyskania spójnej kopii zapasowej zalecane jest krótkie zatrzymanie aplikacji (
docker stop cgate
) i ponowne uruchomienie po wykonaniu kopii zapasowej (docker start cgate
). - C-Gate pyta mnie o dane dostępowe przy starcie. Co muszę tam wpisać?
-
Domyślnie przy instalacji C-Gate jest tworzony użytkownik o nazwie admin. Hasło dla tego użytkownika jest generowane przy pierwszym uruchomieniu kontenera Docker Container i podawane w wierszu poleceń. Możesz wyświetlić dane wyjściowe kontenera Docker Container za pomocą polecenia
Linux (Docker):docker logs cgate
. Poniższe polecenie przedstawia wynik generowania hasła:
Windows (WSL Ubuntu Shell):sudo docker logs cgate | grep UserInitializer
podman logs cgate | grep UserInitializer
W przypadku instalacji w systemie Windows dane dostępu wyświetlane są również raz na koniec instalacji.
- Jak mogę zresetować swoje hasło?
-
Można wymusić nowe hasło administratora poprzez ustawienie zmiennej środowiskowej APP_ADMIN_PASSWORD='NewPassword' dla kontenera C-Gate. Dla instalacji Docker z Docker Compose, na przykład, 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ą naszych instrukcji dla systemu Windows, możesz ustawić hasło w pliku ~/.config/cgate/cgate.conf w WSL, wpisując następujący wiersz:
APP_ADMIN_PASSWORD="MySecretPassword"
- Jak mogę podłączyć moje urządzenia do C-Gate?
-
- Po pierwsze, 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 można alternatywnie podłączyć przez Wifi.
- Następnie urządzenia potrzebują adresu IP i odpowiednich ustawień sieciowych, aby można było do nich dotrzeć z serwera lub komputera, na którym zainstalowany jest C-Gate IoT Hub. Informacje na temat dostosowywania ustawień sieciowych można znaleźć w instrukcji obsługi odpowiedniego urządzenia. Ustawienia sieciowe powinny być przypisane zgodnie z polityką IT. Możesz sprawdzić połączenie, uruchamiając
ping
na IP urządzenia z serwera lub komputera z C-Gate. - Postępuj zgodnie z instrukcjami na interfejsie internetowym C-Gate, aby aktywować swoją licencję. Następnie można skonfigurować urządzenia w widoku urządzeń na C-Gate. Wprowadzić tam odpowiednie adresy IP urządzeń.
Jeśli wszystko zostało prawidłowo skonfigurowane, urządzenia są wyświetlane jako online w widoku urządzeń C-Gate.
Jeśli nadal nie możesz się połączyć, zapoznaj się z naszymi uwagami na temat reguł zapory sieciowej.
- Które reguły zapory i porty muszą być przestrzegane?
-
Następujące porty są istotne z punktu widzenia dostępu do C-Gate IoT Hub:
Przychodzące 80 TCP Interfejs sieciowy i API Przychodzące 4840 TCP Serwer OPC UA do połączenia systemów MES i ERP Przychodzące 5679 TCP Interfejs RPC dla 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 W przypadku starszego sprzętu QIROX (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ć C-Gate IoT Hub?
-
C-Gate może być aktualizowany za pomocą nowego obrazu kontenera.
Linux (Docker-Compose):
Windows:cd /opt/cloos/cgate/ docker-compose pull docker-compose up -d
W menu startowym w folderze C-Gate znajduje się skrypt aktualizacyjny, który przeprowadza aktualizację do aktualnej wersji stabilnej.
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 możliwy jest tylko w obrębie kontenera i są one w ten sposób chronione przed dostępem z zewnątrz.
- 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 jest nadal zablokowane, zainstaluj nasz certyfikat Cloos w swoim systemie i spróbuj ponownie. Upewnij się, że podczas instalacji wybrałeś "Trusted Root Certification Authorities" jako lokalizację dla certyfikatu.
- Zainstalowałem C-Gate na Windowsie ręcznie za pomocą Docker Desktop. Jak zmigrować moje dane do nowej wersji za pomocą instalatora C-Gate?
-
Nowy C-Gate instalator dla Windows automatycznie wykrywa poprzednią instalację z Docker Desktop i importuje dane podczas instalacji. Po zakończeniu 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 restarcie.