C-Gate IoT Hub - 踏出第一步 | C-Gate: 工业4.0一触即发

C-Gate IoT Hub 是以容器格式的软件提供的。建议在每个公司所在地的中央服务器上安装C-Gate IoT Hub 。另外，在标准PC上安装也是可以的。

系统要求

容器运行环境（如Docker、Kubernetes、OpenShift、Podman...）。
8GB内存
128 GB的硬盘空间
64位处理器（建议使用4核）。
互联网连接（在安装和更新期间）。

如果连接了25个以上的控制器，要求可能更高。

C-Gate IoT Hub 容器

C-Gate IoT Hub 容器是由CLOOS在Docker Registry中提供的。当你购买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

强制为管理员用户设置密码。

默认值: 空的

APP_MAX_DATA_SIZE

设置由C-Gate 存储的总数据的最大尺寸，单位是GB。

默认值: 32

分步指南

如果你还没有使用容器运行环境，下面的说明将指导你完成使用C-Gate 的基本容器运行环境的必要步骤。在这种情况下，我们建议你还是要掌握你的集装箱环境，以便能够安全操作。

为你的Linux发行版安装Docker。

执行以下命令来安装和启动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的最新更新。你至少需要版本号为2004 （Build19041 ）的Windows 10或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 IoT Hub 安装程序安装C-Gate ，适用于Windows。

安装后

接下来的步骤和进一步的信息可以在C-Gate 网页界面上找到。安装后，你可以在你的服务器或PC上的http://localhost 。

C-Gate 从另一台电脑上，你可以通过http://[serverip] ，[serverip] ，这里要用你的服务器或安装了C-Gate 的电脑的IP来代替。

常见问题

我的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 job（Linux）或一个计划任务（Windows）。

为了获得一致的备份，建议短暂停止应用程序(docker stop cgate)，并在备份后再次启动(docker start cgate)。

C-Gate 当我启动它时，要求我提供访问数据。我必须在那里输入什么？

默认情况下，在安装C-Gate 时，会创建一个名为admin 的用户。这个用户的密码在Docker容器第一次启动时生成，并在命令行上输出。你可以用命令docker logs cgate ，显示Docker容器的输出。下面的命令为你提供了密码生成的输出。

Linux (Docker):

sudo docker logs cgate | grep UserInitializer

Windows (WSL Ubuntu Shell):

podman logs cgate | grep UserInitializer

在Windows安装时，访问数据也会在安装结束时显示一次。

如何重置我的密码？

你可以通过为你的C-Gate 容器设置环境变量APP_ADMIN_PASSWORD='NewPassword' ，强制设置一个新的管理密码。以使用Docker Compose的Docker安装为例，你可以在environment 行下面的文件docker-compose.yml ，设置这个变量。

例子。

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

如果你用我们的Windows说明安装了C-Gate ，你可以在WSL内的文件~/.config/cgate/cgate.conf ，输入以下一行来设置密码:

APP_ADMIN_PASSWORD="MySecretPassword"

我如何将我的设备连接到C-Gate ？

首先，应该有一个物理连接。对于CLOOS机器人系统，这通常是一条连接到机器人控制器和您公司网络的网线。QINEO焊接单元也可以通过Wifi连接。
然后，你的设备需要一个IP地址和相应的网络设置，以便它们可以从安装了C-Gate IoT Hub 的服务器或PC上到达。有关如何调整网络设置的信息，请参考各设备手册。网络设置应根据你的IT政策来分配。你可以从服务器或PC上使用C-Gate ，在设备IP上运行ping ，来检查连接。
按照C-Gate 网页界面上的C-Gate 说明来激活你的许可证。然后你可以在C-Gate ，在设备视图中配置你的设备。在那里输入设备的相应IP地址。

如果一切设置正确，设备在C-Gate 设备视图中显示为在线。

如果你仍然无法连接，请参考我们关于防火墙规则的说明。

必须遵守哪些防火墙规则和端口？

以下端口与访问C-Gate IoT Hub 。

入站	80	TCP	网络界面和API
入站	4840	TCP	OPC UA服务器用于连接你的MES和ERP系统
入站	5679	TCP	C-Gate 的RPC接口IoT Connector

如果没有IoT Connector ，C-Gate IoT Hub ，还可以建立与下列端口的连接。

外发	48010	TCP	机器人系统
外发	52341	TCP	焊接设备
外发	4840	TCP	PLC

对于QIROX的传统硬件（比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证书并再次尝试。请确保在安装时选择 "受信任的根认证机构 "作为证书的位置。

我已经使用Docker Desktop在Windows上手动安装了C-Gate 。我如何用C-Gate 安装程序将我的数据迁移到新版本？

新的C-Gate Windows的安装程序会自动检测到之前用Docker Desktop进行的安装，并在安装期间导入数据。安装后，请确保你的C-Gate 安装工作如常。之后，请从Docker Desktop中删除C-Gate 容器，这样它就不会在重启后再次自动启动。

我在Windows下安装的C-Gate 的更新报告了一个访问数据的错误。我怎样才能解决这个问题呢？

在Windows下安装的旧版C-Gate ，CLOOS Docker Repository的访问数据有一部分没有被永久保存。为了解决这个问题，请在你的WSL安装中（Ubuntu）执行以下命令，并输入你在C-Gate 许可证中收到的访问数据。

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