C-Gate IoT Hub - Первые шаги | C-Gate: С поддержкой Industry 4.0

Сайт C-Gate IoT Hub предоставляется в виде программного обеспечения в формате контейнера. Рекомендуется установить C-Gate IoT Hub на центральном сервере для каждого подразделения компании. Также возможна установка на стандартный ПК.

Системные требования

Среда выполнения контейнеров (например, Docker, Kubernetes, OpenShift, Podman, ...)
8 ГБ ОЗУ
128 ГБ пространства на жестком диске
64-разрядный процессор (рекомендуется 4 ядра)
Подключение к Интернету (во время установки и обновления)

Если подключено более 25 контроллеров, требования могут быть выше.

C-Gate IoT Hub Контейнер

Контейнер C-Gate IoT Hub предоставлен CLOOS в реестре Docker. Вы получите необходимые данные доступа при покупке C-Gate IoT Hub .

URL реестра и изображения

docker.cloos.de/cgate

Пример тестовой среды с Docker

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

Пример продуктивной среды с 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:

Тома

C-Gate хранит все конфигурации и данные в каталоге /data. Для этого каталога должен быть использован том для хранения данных.

Открытые порты

4840 (OPC UA Server)
5000/tcp (Связь с роботами до V6)
5000/udp (Связь с роботами до V6)
5005 (Связь с роботами до V6)
5010 (Связь с роботами до V6)
5679 (IoT Connector RPC)
8080 (Web Interface)

Переменные

APP_ADMIN_PASSWORD

Ввод пароля для пользователя admin.

Значение по умолчанию: Пустой

APP_MAX_DATA_SIZE

Устанавливает максимальный размер всех данных, хранящихся на сайте C-Gate, в ГБ.

Значение по умолчанию: 32

Пошаговое руководство

Если вы еще не используете среду выполнения контейнеров, следующие инструкции помогут вам выполнить необходимые шаги для создания базовой среды выполнения контейнеров с помощью C-Gate. В этом случае мы рекомендуем вам все же ознакомиться с условиями эксплуатации вашего контейнера, чтобы иметь возможность безопасно им управлять.

Установите Docker для вашего дистрибутива Linux.

Выполните следующие команды для установки и запуска 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
# Введите сюда данные доступа, которые вы получили от CLOOS.
sudo docker compose up -d
# Дайте приложению несколько секунд для запуска.
# Прочитайте сгенерированный пароль для пользователя admin с помощью следующей команды:
sudo docker logs cgate | grep UserInitializer

Мы рекомендуем установку под операционной системой Linux, так как контейнеры там уже установлены в течение нескольких лет. В Windows, с другой стороны, контейнеры в настоящее время все еще в новинку. Поэтому следует ожидать более частых изменений, несколько большего потребления ресурсов и более сложных задач при настройке и эксплуатации.

Убедитесь, что установлено последнее обновление для Windows. Вам потребуется Windows 10, по крайней мере, с номера версии 2004 (Build 19041) или Windows 11.

Чтобы отобразить версию Windows, в командной строке можно выполнить следующую команду:
```
winver
```

Установите WSL (Windows Subsystem for Linux) с помощью следующих команд в командной строке:

wsl --set-default-version 2
# Далее выберите любое имя пользователя и пароль.
# Здесь нет необходимости вводить данные доступа CLOOS.
wsl --install -d Ubuntu
wsl --set-default Ubuntu

Установите C-Gate с помощью нашей программы установкиC-Gate IoT Hub для Windows.

После установки

Следующие шаги и дополнительную информацию можно найти на веб-интерфейсе C-Gate. После установки вы можете получить к нему доступ по адресу http://localhost на вашем сервере или ПК.

С другого компьютера вы можете обратиться к C-Gate по адресу http://[serverip], где [serverip] заменяется IP вашего сервера или компьютера, на котором установлен C-Gate.

Часто задаваемые вопросы

Где хранятся мои данные C-Gate?

В Docker данные обычно хранятся в так называемых томах. C-Gate использует один такой том для внутреннего каталога /data.

Как создать резервную копию данных C-Gate?

Вы можете создать резервную копию своих данных с помощью следующей команды. Резервная копия сохраняется в папке, в которой выполняется команда.

Linux (Docker):

# Создание резервной копии
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Восстановление резервной копии
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):

# Создание резервной копии
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Восстановление резервной копии
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Для ежедневного резервного копирования, например, можно использовать задание cron (Linux) или запланированное задание (Windows).

Для последовательного резервного копирования рекомендуется кратковременно остановить приложение (docker stop cgate) и запустить его снова после резервного копирования (docker start cgate).

C-Gate запрашивает у меня данные доступа при запуске. Что я должен там ввести?

По умолчанию при установке C-Gate создается пользователь с именем admin. Пароль для этого пользователя генерируется при первом запуске Docker Container и выводится в командной строке. Вы можете отобразить вывод Docker-контейнера с помощью команды docker logs cgate. Следующая команда выводит результаты генерации пароля:

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

При установке Windows данные доступа также отображаются один раз в конце установки.

Как я могу сбросить свой пароль?

Вы можете принудительно ввести новый пароль администратора, установив переменную окружения APP_ADMIN_PASSWORD='NewPassword' для вашего контейнера C-Gate. Для установки Docker с Docker Compose, например, вы можете установить эту переменную в файле docker-compose.yml под строкой environment.

Пример:

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

Если вы установили C-Gate с помощью наших инструкций для Windows, вы можете установить пароль в файле ~/.config/cgate/cgate.conf в WSL, введя следующую строку:

APP_ADMIN_PASSWORD="MySecretPassword"

Как подключить мои устройства к C-Gate?

Прежде всего, должно быть доступно физическое подключение. Для робототехнических систем CLOOS это обычно сетевой кабель, подключенный к контроллеру робота и сети вашей компании. Сварочные аппараты QINEO можно также подключать через Wifi.
Затем вашим устройствам необходим IP-адрес и соответствующие сетевые настройки, чтобы они могли быть доступны с сервера или ПК, на котором установлен C-Gate IoT Hub . Информацию о том, как настроить параметры сети, см. в руководстве к соответствующему устройству. Сетевые настройки должны быть назначены в соответствии с вашей ИТ-политикой. Вы можете проверить соединение, запустив ping на IP устройства с сервера или ПК с помощью C-Gate.
Следуйте инструкциям C-Gate в веб-интерфейсе C-Gate для активации лицензии. Затем вы можете настроить свои устройства в представлении устройства на сайте C-Gate. Введите соответствующие IP-адреса устройств.

Если все настроено правильно, устройства отображаются как онлайн в представлении устройств C-Gate.

Если вы все еще не можете подключиться, обратитесь к нашим заметкам о правилах брандмауэра.

Какие правила и порты брандмауэра должны соблюдаться?

Для доступа к C-Gate IoT Hub используются следующие порты:

Входящий	80	TCP	Веб-интерфейс и API
Входящий	4840	TCP	Сервер OPC UA для подключения ваших MES и ERP систем
Входящий	5679	TCP	RPC-интерфейс для C-Gate IoT Connector

Без IoT Connector, C-Gate IoT Hub дополнительно устанавливает соединения со следующими портами:

Исходящий	48010	TCP	Робототехнические системы
Исходящий	52341	TCP	Сварочное оборудование
Исходящий	4840	TCP	ПЛК

В аппаратном обеспечении QIROX Legacy Hardware (аппаратное обеспечение старше V7) используются следующие дополнительные порты:

Входящий	5000	TCP
Входящий	5000	UDP
Входящий	5005	TCP
Входящий	5010	TCP

Как я могу обновить C-Gate IoT Hub ?

C-Gate можно обновить с помощью нового образа контейнера.

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:

В меню Пуск в папке C-Gate находится скрипт обновления, который выполняет обновление до текущей стабильной версии.

Существующие данные автоматически переносятся приложением при их обновлении. В зависимости от объема данных, процесс миграции может задержать запуск новой версии приложения на несколько минут. В это время приложение недоступно.

Что находится внутри контейнера C-Gate?

Контейнер C-Gate IoT Hub основан на текущем официальном базовом образе Ubuntu и содержит следующие службы. Только сервисы с соответствующей спецификацией порта могут быть доступны извне контейнера. Доступ к сервисам без спецификаций портов возможен только внутри контейнера, поэтому они защищены от внешнего доступа.

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

Почему Windows блокирует выполнение установки C-Gate?

Загруженные файлы .exe легко классифицируются Windows как угроза. Следующая команда Powershell может быть использована для исправления этой классификации для файла:

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

Если установка или выполнение включенных файлов сценариев по-прежнему блокируется, пожалуйста, установите наш сертификат Cloos в вашей системе и повторите попытку. Пожалуйста, убедитесь, что во время установки вы выбрали "Доверенные корневые центры сертификации" в качестве местоположения для сертификата.

Я вручную установил C-Gate на Windows с помощью Docker Desktop. Как перенести данные на новую версию с помощью программы установки C-Gate?

Новая программа установки C-Gate для Windows автоматически обнаруживает предыдущую установку с Docker Desktop и импортирует данные во время установки. После установки, пожалуйста, убедитесь, что ваша установка C-Gate работает как обычно. После этого, пожалуйста, удалите контейнер C-Gate из Docker Desktop, чтобы он не запускался снова автоматически после перезагрузки.

Обновление моей установки C-Gate под Windows сообщает об ошибке с данными доступа. Как я могу это исправить?

При использовании более старой установки C-Gate под Windows данные доступа к репозиторию CLOOS Docker Repository частично не сохранялись постоянно. Чтобы устранить проблему, выполните следующую команду в вашей установке WSL (Ubuntu) и введите данные доступа, которые вы получили вместе с лицензией C-Gate:

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