C-Gate IoT Hub첫 번째 단계

C-Gate IoT Hub 은 컨테이너 형식의 소프트웨어로 제공됩니다. C-Gate IoT Hub 을 회사 위치별 중앙 서버에 설치하는 것이 좋습니다. 또는 일반 PC에 설치하는 것도 가능합니다.

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

관리자 사용자에게 비밀번호를 강제 설정합니다.

기본값: 빈

APP_MAX_DATA_SIZE

C-Gate 에 저장되는 총 데이터의 최대 크기를 GB 단위로 설정합니다.

기본값: 32

자주 묻는 질문

내 C-Gate 데이터는 어디에 저장되나요?

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"

예를 들어 일일 백업의 경우 크론 작업 (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 에 어떻게 연결하나요?

1. 우선, 물리적 연결이 가능해야 합니다. CLOOS 로봇 시스템의 경우 일반적으로 로봇 컨트롤러와 회사 네트워크에 연결된 네트워크 케이블입니다. QINEO 용접 유닛은 Wi-Fi를 통해 연결할 수도 있습니다.
2. 그런 다음 C-Gate IoT Hub 이 설치된 서버 또는 PC에서 연결할 수 있도록 장치에 IP 주소와 해당 네트워크 설정이 필요합니다. 네트워크 설정을 조정하는 방법에 대한 자세한 내용은 각 장치 설명서를 참조하세요. 네트워크 설정은 IT 정책에 따라 할당해야 합니다. C-Gate 을 사용하여 서버 또는 PC에서 장치 IP로 ping 을 실행하여 연결을 확인할 수 있습니다.
3. C-Gate 웹 인터페이스의 C-Gate 지침에 따라 라이선스를 활성화합니다. 그런 다음 C-Gate 의 장치 보기에서 장치를 구성할 수 있습니다. 여기에 장치의 해당 IP 주소를 입력합니다.

모든 것이 올바르게 설정되면 C-Gate 장치 보기에서 장치가 온라인 상태로 표시됩니다.

그래도 연결할 수 없는 경우 방화벽 규칙에 대한 참고 사항을 참조하세요.

링크 복사링크 복사 완료!

어떤 방화벽 규칙과 포트를 준수해야 하나요?

다음 포트는 C-Gate IoT Hub 접속과 관련이 있습니다:

인바운드	80	TCP	웹 인터페이스 및 API
인바운드	4840	TCP	MES 및 ERP 시스템 연결을 위한 OPC UA 서버
인바운드	5679	TCP	C-Gate 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 컨테이너는 현재 공식 우분투 기본 이미지를 기반으로 하며 다음과 같은 서비스를 포함합니다. 해당 포트 사양을 가진 서비스만 컨테이너 외부에서 액세스할 수 있습니다. 포트 사양이 없는 서비스는 컨테이너 내에서만 액세스할 수 있으므로 외부 액세스로부터 보호됩니다.

• 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'

포함된 스크립트 파일의 설치 또는 실행이 여전히 차단된 경우, 시스템에 클루스 인증서를 설치한 후 다시 시도하세요. 설치하는 동안 인증서 위치로 '신뢰할 수 있는 루트 인증 기관'을 선택해야 합니다.

링크 복사링크 복사 완료!

Docker Desktop을 사용하여 Windows에 C-Gate 을 수동으로 설치했습니다. C-Gate 설치 관리자를 사용하여 데이터를 새 버전으로 마이그레이션하려면 어떻게 해야 하나요?

새로운 Windows용 C-Gate 설치 관리자는 설치 중에 Docker 데스크톱을 사용한 이전 설치를 자동으로 감지하고 데이터를 가져옵니다. 설치가 완료되면 C-Gate 설치가 정상적으로 작동하는지 확인하세요. 그 후에는 재부팅 후 자동으로 다시 시작되지 않도록 Docker Desktop에서 C-Gate 컨테이너를 삭제하세요.

링크 복사링크 복사 완료!

Windows에서 C-Gate 설치를 업데이트하면 액세스 데이터에 오류가 발생한다고 보고합니다. 이 문제를 해결하려면 어떻게 해야 하나요?

Windows에서 이전 C-Gate 버전을 설치한 경우, CLOOS Docker 리포지토리에 대한 액세스 데이터가 부분적으로 영구적으로 저장되지 않았습니다. 이 문제를 해결하려면 WSL 설치(우분투)에서 다음 명령을 실행하고 C-Gate 라이선스와 함께 받은 액세스 데이터를 입력하세요:

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

링크 복사링크 복사 완료!