C-Gate IoT Hub bir konteyner formatında yazılım olarak sağlanır. C-Gate IoT Hub adresinin her şirket konumu için merkezi bir sunucuya kurulması önerilir. Alternatif olarak, standart bir PC'ye kurulum da mümkündür.

Sistem gereksinimleri

  • Konteyner çalışma zamanı ortamı (örneğin Docker, Kubernetes, OpenShift, Podman, ...)
  • 8 GB RAM
  • 128 GB sabit disk alanı
  • 64 bit işlemci (4 çekirdek önerilir)
  • İnternet bağlantısı (kurulum ve güncelleme sırasında)
25'ten fazla kontrol ünitesi bağlıysa gereksinimler daha fazla olabilir.

C-Gate IoT Hub Konteyner

C-Gate IoT Hub konteyneri CLOOS tarafından Docker Registry'de sağlanmaktadır. Bir C-Gate IoT Hub satın aldığınızda gerekli erişim verilerini alacaksınız.

Kayıt ve Görüntü URL'si

docker.cloos.de/cgate

Docker ile test ortamı örneği

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

Docker Compose ile üretken bir ortam örneği

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:

Ciltler

C-Gate tüm konfigürasyonları ve verileri /data dizininde saklar. Verilerin kalıcı olması için bu dizin için bir birim kullanılmalıdır.

Açıkta Kalan Bağlantı Noktaları

  • 4840 (OPC UA Server)
  • 5000/tcp (V6'ya kadar robot iletişimi)
  • 5000/udp (V6'ya kadar robot iletişimi)
  • 5005 (V6'ya kadar robot iletişimi)
  • 5010 (V6'ya kadar robot iletişimi)
  • 5679 (IoT Connector RPC)
  • 8080 (Web Interface)

Değişkenler

APP_ADMIN_PASSWORD

Yönetici kullanıcısı için bir parola zorlar.

Varsayılan değer: Boş

APP_MAX_DATA_SIZE

C-Gate tarafından depolanan toplam verinin maksimum boyutunu GB cinsinden ayarlar.

Varsayılan değer: 32

Adım adım kılavuz

Henüz bir konteyner çalışma zamanı ortamı kullanmıyorsanız, aşağıdaki talimatlar C-Gate ile temel bir konteyner çalışma zamanı ortamı için gerekli adımlarda size yol gösterecektir. Bu durumda, güvenli bir şekilde çalıştırabilmek için yine de konteyner ortamınızı tanımanızı öneririz.

  1. Linux dağıtımınız için Docker'ı yükleyin.
  2. C-Gate adresini yüklemek ve başlatmak için aşağıdaki komutları yürütün:
    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'tan aldığınız erişim verilerini buraya girin.
    sudo docker compose up -d
    # Uygulamaya başlaması için birkaç saniye verin.
    # Aşağıdaki komutla admin kullanıcısı için oluşturulan parolayı okuyun:
    sudo docker logs cgate | grep UserInitializer

Linux işletim sistemi altında bir kurulum öneriyoruz, çünkü konteynerler zaten birkaç yıldır orada kurulmuştur. Öte yandan Windows altında, konteynerler şu anda hala yenidir. Bu nedenle daha sık değişiklikler, biraz daha yüksek kaynak tüketimi ve kurulum ve çalıştırma sırasında daha fazla zorluk beklemelisiniz.

  1. Windows için en son güncellemenin yüklü olduğundan emin olun. En azından 2004 (Build 19041) veya Windows 11 sürüm numarasından Windows 10'a ihtiyacınız var.

    Windows sürümünü görüntülemek için komut satırında aşağıdaki komut çalıştırılabilir:
    winver
  2. Komut satırında aşağıdaki komutları kullanarak WSL'yi (Linux için Windows Alt Sistemi) kurun:
    wsl --set-default-version 2
    # Aşağıda, herhangi bir kullanıcı adı ve parola seçin.
    # CLOOS erişim verilerinin buraya girilmesi gerekli değildir.
    wsl --install -d Ubuntu
    wsl --set-default Ubuntu
  3. Windows içinC-Gate IoT Hub yükleyicimiz ile C-Gate 'u yükleyin.

Kurulumdan sonra

Sonraki adımlar ve daha fazla bilgi C-Gate web arayüzünde bulunabilir. Kurulumdan sonra sunucunuzda veya bilgisayarınızda http://localhost adresinden buna erişebilirsiniz.

Başka bir bilgisayardan C-Gate adresine http://[serverip] adresinden ulaşabilirsiniz; burada [serverip] yerine C-Gate 'un kurulu olduğu sunucunuzun veya bilgisayarınızın IP'si yazılmalıdır.

Sıkça sorulan sorular

C-Gate verilerim nerede saklanıyor?

Docker altında, veriler genellikle sözde birimlerde saklanır. C-Gate, /data dahili dizini için böyle bir birim kullanır.

C-Gate verilerimin yedeğini nasıl oluşturabilirim?

Aşağıdaki komutla verilerinizin yedeğini oluşturabilirsiniz. Yedekleme, komutun çalıştırıldığı klasörde saklanır.

Linux (Docker):
# Yedek oluşturun
sudo docker run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Yedeklemeyi geri yükleme
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):
# Yedek oluşturun
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu tar cvzf /backup/cgate-backup.tar.gz /data

# Yedeklemeyi geri yükleme
podman run --rm --volumes-from cgate -v $(pwd):/backup ubuntu bash -c "cd /data && tar xvzf /backup/cgate-backup.tar.gz --strip 1"

Örneğin günlük yedekleme için bir cron işi (Linux) veya zamanlanmış bir görev (Windows) kullanılabilir.

Tutarlı bir yedekleme için, uygulamanın kısa bir süre durdurulması (docker stop cgate) ve yedeklemeden sonra tekrar başlatılması (docker start cgate) önerilir.

C-Gate başlattığımda benden erişim verilerini istiyor. Oraya ne girmem gerekiyor?

Varsayılan olarak, C-Gate yüklendiğinde admin adında bir kullanıcı oluşturulur. Bu kullanıcı için parola, Docker Container ilk kez başlatıldığında oluşturulur ve komut satırında verilir. Docker Konteynerinin çıktısını docker logs cgate komutu ile görüntüleyebilirsiniz. Aşağıdaki komut size parola oluşturma çıktısını sağlar:

Linux (Docker):
sudo docker logs cgate | grep UserInitializer
Windows (WSL Ubuntu Shell):
podman logs cgate | grep UserInitializer

Windows kurulumu ile erişim verileri de kurulumun sonunda bir kez görüntülenir.

Şifremi nasıl sıfırlayabilirim?

C-Gate konteyneriniz için APP_ADMIN_PASSWORD='NewPassword' ortam değişkenini ayarlayarak yeni bir yönetici parolasını zorlayabilirsiniz. Örneğin Docker Compose ile bir Docker kurulumu için, bu değişkeni environment satırının altındaki docker-compose.yml dosyasında ayarlayabilirsiniz.

Örnek:

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

Windows talimatlarımızla C-Gate adresini yüklediyseniz, aşağıdaki satırı girerek WSL içindeki ~/.config/cgate/cgate.conf dosyasında parolayı ayarlayabilirsiniz:

APP_ADMIN_PASSWORD="MySecretPassword"

Cihazlarımı C-Gate adresine nasıl bağlarım?
  1. Her şeyden önce fiziksel bir bağlantı mevcut olmalıdır. CLOOS robot sistemleri için bu genellikle robot kontrolörüne ve şirket ağınıza bağlı bir ağ kablosudur. QINEO kaynak üniteleri alternatif olarak Wifi üzerinden bağlanabilir.
  2. Ardından, cihazlarınıza C-Gate IoT Hub adresinin yüklü olduğu sunucudan veya bilgisayardan erişilebilmesi için bir IP adresine ve ilgili ağ ayarlarına ihtiyaç duyulur. Ağ ayarlarının nasıl yapılacağı hakkında bilgi için lütfen ilgili cihaz kılavuzuna bakın. Ağ ayarları BT politikanıza göre atanmalıdır. Bağlantıyı, C-Gate adresini kullanarak sunucudan veya bilgisayardan cihaz IP'sinde bir ping çalıştırarak kontrol edebilirsiniz.
  3. Lisansınızı etkinleştirmek için C-Gate web arayüzündeki C-Gate talimatlarını izleyin. Daha sonra cihazlarınızı C-Gate adresindeki cihaz görünümünde yapılandırabilirsiniz. Cihazların ilgili IP adreslerini buraya girin.

Her şey doğru ayarlanmışsa, cihazlar C-Gate cihaz görünümünde çevrimiçi olarak görünür.

Hala bağlanamıyorsanız, lütfen güvenlik duvarı kuralları hakkındaki notlarımıza bakın.

Hangi güvenlik duvarı kurallarına ve bağlantı noktalarına uyulmalıdır?

Aşağıdaki bağlantı noktaları C-Gate IoT Hub adresine erişimle ilgilidir:

Gelen 80 TCP Web arayüzü ve API
Gelen 4840 TCP MES ve ERP sistemlerinizin bağlantısı için OPC UA sunucusu
Gelen 5679 TCP C-Gate için RPC arayüzü IoT Connector

IoT Connector olmadan, C-Gate IoT Hub ek olarak aşağıdaki bağlantı noktalarına bağlantı kurar:

Giden 48010 TCP Robot sistemleri
Giden 52341 TCP Kaynak ekipmanları
Giden 4840 TCP PLC

QIROX Legacy Hardware (V7'den eski donanım) ile aşağıdaki ek portlar kullanılır:

Gelen 5000 TCP
Gelen 5000 UDP
Gelen 5005 TCP
Gelen 5010 TCP

C-Gate IoT Hub adresini nasıl güncelleyebilirim?

C-Gate yeni bir konteyner görüntüsü ile güncel hale getirilebilir.

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:

Başlat menüsünde C-Gate klasörü altında mevcut kararlı sürüme güncelleme yapan bir güncelleme betiği bulunmaktadır.

Mevcut veriler güncellendiğinde uygulama tarafından otomatik olarak taşınır. Veri miktarına bağlı olarak, geçiş işlemi yeni uygulama sürümünün başlamasını birkaç dakika geciktirebilir. Uygulama bu süre zarfında kullanılamaz.

C-Gate konteynerinin içinde ne var?

C-Gate IoT Hub konteyneri güncel bir resmi Ubuntu temel imajını temel alır ve aşağıdaki hizmetleri içerir. Yalnızca ilgili bağlantı noktası belirtimine sahip hizmetlere konteyner dışından erişilebilir. Bağlantı noktası özellikleri olmayan hizmetlere yalnızca konteyner içinden erişilebilir ve bu nedenle harici erişime karşı korunur.

  • 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 kurulumunun yürütülmesini neden engelliyor?

İndirilen .exe dosyaları Windows tarafından kolayca bir tehdit olarak sınıflandırılır. Dosya için bu sınıflandırmayı düzeltmek üzere aşağıdaki Powershell komutu kullanılabilir:

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

Dahil edilen komut dosyalarının yüklenmesi veya yürütülmesi hala engelleniyorsa, lütfen Cloos sertifikamızı sisteminize yükleyin ve tekrar deneyin. Lütfen kurulum sırasında sertifikanın konumu olarak "Güvenilir Kök Sertifika Yetkilileri "ni seçtiğinizden emin olun.

Docker Desktop kullanarak Windows'a C-Gate adresini manuel olarak yükledim. Verilerimi C-Gate yükleyicisi ile yeni sürüme nasıl taşıyabilirim?

Windows için yeni C-Gate yükleyicisi, Docker Desktop ile önceki bir yüklemeyi otomatik olarak algılar ve yükleme sırasında verileri içe aktarır. Kurulumdan sonra, lütfen C-Gate kurulumunuzun her zamanki gibi çalıştığından emin olun. Daha sonra, yeniden başlatma sonrasında otomatik olarak yeniden başlamaması için lütfen C-Gate konteynerini Docker Desktop'tan silin.

Windows altında C-Gate kurulumumun güncellemesi erişim verileriyle ilgili bir hata bildiriyor. Bunu nasıl düzeltebilirim?

Windows altındaki eski bir C-Gate kurulumunda, CLOOS Docker Deposuna erişim verileri kısmen kalıcı olarak saklanmıyordu. Sorunu çözmek için lütfen WSL kurulumunuzda (Ubuntu) aşağıdaki komutu çalıştırın ve C-Gate lisansınızla birlikte aldığınız erişim verilerini girin:

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