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)
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.
- Linux dağıtımınız için Docker'ı yükleyin.
-
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.
-
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
-
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
- 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):
Windows (WSL Ubuntu Shell):# 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"
# 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ı
Linux (Docker):docker logs cgate
komutu ile görüntüleyebilirsiniz. Aşağıdaki komut size parola oluşturma çıktısını sağlar:
Windows (WSL Ubuntu Shell):sudo docker logs cgate | grep UserInitializer
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?
-
- 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.
- 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. - 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):
Windows:cd /opt/cloos/cgate/ docker-compose pull docker-compose up -d
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.
- 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