İnternet erişimi olmadan kurulum

Bu kılavuzu tamamladığınızda Proxus merkez sunucusu internete erişemeyen bir makinede çalışır, lisansı etkin olur ve aynı kapalı ağdaki Edge Gateway'ler kurulabilir. Dosyaları internet erişimi olan bir makinede hazırlar, örneğin bir USB bellekle taşırsınız.

Proxus ağınızın içinde veri toplamak, saklamak, göstermek ve aktarmak için internet bağlantısına ihtiyaç duymaz. Normalde internetten gelen iki şey vardır ve bu sayfa ikisinin de yerini tutar: kurulum betiği (proxus.io adresinden) ve konteyner imajları (Docker Hub'dan).

Başlamadan önce

Şunlar hazır olmalı:

• Dosyaları indirmek için Docker kurulu, internete bağlı bir makine. Hedef makinelerle aynı işlemci türünde olmalı (x86-64 ya da ARM64). Değilse her docker pull komutuna --platform ekleyin, örneğin --platform linux/arm64.
• Kapalı ağda, Docker Engine ve Docker Compose eklentisi önceden kurulmuş ve sistem gereksinimlerini karşılayan merkez sunucu makinesi. Docker Proxus dosyalarına dahil değildir. Önce işletim sisteminizin çevrim dışı paketlerinden kurun.
• Merkez sunucu makinesine yaklaşık 2-3 GB dosya taşıyabileceğiniz bir yol.
• Bir lisans anahtarı ya da merkez sunucunun Lisans kimliği değerini başka bir makineden Proxus'a veya distribütörünüze gönderebileceğiniz bir yol (Adım 5 bölümüne bakın).

Adım 1: Dosyaları internete bağlı makinede indirin

1. Sürümün Docker Compose paketini, proxus-docker_<sürüm>.zip, Proxus sürümleri sayfasından indirin ve sürümün SHA256SUMS.txt dosyasıyla doğrulayın. Paket o sürümün kurulum betiklerini, docker-compose.yml dosyasını ve Keycloak dosyalarını içerir.

2. Paketi açın ve sürümün kullandığı imajları listeleyin:

   cd proxus-docker_2.1.0
   docker compose config --images

   2.1.0 için bunlar proxusplatform/proxus-ui:2.1.0, proxusplatform/proxus-server:2.1.0, nats:2.15.1-alpine, postgres:16 ve bitnamilegacy/clickhouse:25.5.2 imajlarıdır. Keycloak ile ayrıca quay.io/keycloak/keycloak:26.0.7.

3. İmajları indirin ve tek bir dosyaya kaydedin:

   docker compose config --images | xargs -n1 docker pull
   docker save -o proxus-hub-images.tar $(docker compose config --images)

4. Kapalı ağdaki başka makinelere Edge Gateway kuracaksanız onların imajlarını da kaydedin. Bir Edge Gateway, aynı proxus-server imajını kendine ait küçük bir mesaj sunucusuyla birlikte çalıştırır:

   docker pull nats:2-alpine
   docker save -o proxus-edge-images.tar proxusplatform/proxus-server:2.1.0 nats:2-alpine

Açtığınız paket klasörünü ve .tar dosyalarını taşınabilir diske kopyalayın.

Adım 2: İmajları merkez sunucu makinesine yükleyin

Dosyaları merkez sunucu makinesine kopyalayın, ardından imajları yükleyin:

docker load -i proxus-hub-images.tar
docker image ls

docker image ls yukarıdaki etiketlerle imajları listeler. Docker Compose makinede zaten bulunan bir imajı kullanır ve hiçbir şey indirmez.

Adım 3: Merkez sunucuyu başlatın

Proxus'un duracağı klasörde (örneğin /opt) taşıdığınız paket klasöründeki kurulum betiğini çalıştırın:

cd /opt
bash /media/usb/proxus-docker_2.1.0/install.sh

cd C:\Proxus
powershell -ExecutionPolicy Bypass -File E:\proxus-docker_2.1.0\install.ps1

Betiğin internet erişimine ihtiyacı yoktur: compose dosyalarını çalıştığı paket klasöründen, sürümü de onlardan alır. Docker Hub'a ulaşılamadığında yüklenmiş imajları kullanır (eksik olan varsa adını söyler). Normal bir kurulumla aynı soruları sorar ve proxus-platform/ klasörünü yazar. Start Proxus now? sorusuna Y yanıtı verin.

Bunun yerine kendi compose dosyanızla kurmak için Compose dosyasından kurun bölümünü izleyin. Oradaki docker compose up -d da yüklenmiş imajları kullanır.

Bütün servislerin çalıştığını ve sağlıklı olduğunu kontrol edin:

cd proxus-platform
docker compose ps

Adım 4: Merkez sunucuya internet erişimi olmadığını bildirin

Edge Gateway kurulum penceresi, merkez sunucunun internetteki genel adresini de önerir. Merkez sunucu bu adresi internete sorarak bulur. Kapalı ağda bu sorgu sonuç vermez ve listede yalnızca yerel adresler görünür. Sorguyu tamamen kapatmak için proxus-platform/docker-compose.override.yml dosyasına şunu ekleyin ve o klasörde docker compose up -d komutunu çalıştırın:

services:
  proxus-ui:
    environment:
      Service__DetectPublicAddress: "false"

Adım 5: Lisansı etkinleştirin

Lisans, merkez sunucuda anahtarın dijital imzasıyla doğrulanır. Etkinleştirme sırasında Proxus'a bağlanılmaz. Bu yüzden kapalı ağda da aynı şekilde çalışır.

1. https://<host>:8443 adresini açın ve İlk kez oturum açın bölümündeki gibi Admin kullanıcısıyla, parolayı boş bırakarak oturum açın.
2. Lisans etkinleştirme penceresinde Lisans kimliği değerinin yanındaki Kopyala düğmesine tıklayın ve değeri not edin ya da bir dosyaya kaydedin.
3. E-posta ya da internet erişimi olan herhangi bir makineden Lisans kimliğini Proxus'a veya distribütörünüze gönderin. Size gönderilen anahtar yalnızca bu kimlikle çalışır.
4. Anahtarı Lisans anahtarı alanına yapıştırın, sözleşmeyi kabul edin ve Lisansı etkinleştir düğmesine tıklayın.

Lisans kimliği, merkez sunucunun çalıştığı makineden ve yapılandırma biriminden türetilir. Merkez sunucuyu taşırken ya da geri yüklerken ikisini de koruyun, aksi hâlde yeni bir anahtar isteyin. Bkz. Lisans.

Kapalı ağa Edge Gateway kurun

Edge Gateway'in yalnızca merkez sunucuya erişmesi gerekir: 7422 portuna ve merkez sunucunun HTTPS portuna (varsayılan 8443).

1. Edge Gateway makinesinde, Adım 1'de kaydettiğiniz imajları yükleyin:

   docker load -i proxus-edge-images.tar

2. Edge Gateway'i merkez sunucuda oluşturun ve kurulum komutunu Edge Gateway kurun sayfasındaki gibi çalıştırın. Komut merkez sunucudan geldiği için internet erişimi gerekmez. İmaj indirilemezse kurulum betiği makinede zaten bulunan imajları kullanır ve devam eder.

Edge Gateway imajını kendi ağınızdaki bir imaj deposundan almak isterseniz, proxus-ui servisinde EdgeDeployment__Image değerini imajın o depodaki tam adına ayarlayın, örneğin registry.plant.local/proxusplatform/proxus-server:latest. Kurulum komutu bundan sonra bu adı kullanır.

Neler internet gerektirir, yerine ne kullanılır

İnternet erişimi olmadan yükseltme

Yeni sürüm için Adım 1'i internete bağlı makinede tekrarlayın, paket klasörünü ve imajları taşıyın; ardından merkez sunucu makinesinde imajları yükleyin ve proxus-platform klasörünü içeren klasörde yeni paketin kurulum betiğini çalıştırın:

docker load -i proxus-hub-images.tar
cd /opt
bash /media/usb/proxus-docker_2.2.0/install.sh update

Betik yedek alır, yeni sürüme geçer ve sürüm başlamazsa kendiliğinden geri döner; bkz. Yükseltme. Önce o sayfayı okuyun: her sürümden sonra ne yapılacağını anlatır.

Her Edge Gateway makinesinde yeni imajları yükleyin ve Edge Gateway'i kendi klasöründe yeniden oluşturun. Edge Gateway'leri yükseltin bölümündeki pull adımını atlayın:

docker load -i proxus-edge-images.tar
cd /opt/proxus/proxus-edge-3
sudo docker compose -p proxus-edge-3 -f compose.yaml up -d

Sonraki adımlar

• Tesis ağını bağlamadan önce kurulumu sağlamlaştırın.
• config birimi dahil kurulumu yedekleyin.
• Günlük komutlar için Proxus'u Docker ile çalıştırın.