İ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. Merkez sunucu makinesinin işletim sistemine uygun kurulum betiğini indirin:

   curl -fsSL https://proxus.io/install.sh -o install.sh

   Invoke-WebRequest https://proxus.io/install.ps1 -OutFile install.ps1

   Proxus teslimatınızla hazır bir docker-compose.yml geldiyse kurulum betiği yerine o dosyayı da kullanabilirsiniz.

2. Merkez sunucunun kullandığı imajları indirin:

   docker pull proxusplatform/proxus-ui:latest
   docker pull proxusplatform/proxus-server:latest
   docker pull nats:alpine
   docker pull postgres:16
   docker pull bitnamilegacy/clickhouse:latest

   Bunlar, kurulum betiğinin yazdığı compose dosyasındaki imajlardır. Teslimatınızla gelen bir compose dosyası kullanıyorsanız, dosyanın klasöründe docker compose config --images komutu gereken imajları listeler.

3. İmajları tek bir dosyaya kaydedin:

   docker save -o proxus-hub-images.tar \
     proxusplatform/proxus-ui:latest proxusplatform/proxus-server:latest \
     nats:alpine postgres:16 bitnamilegacy/clickhouse:latest

4. Kapalı ağdaki başka makinelere Edge Gateway kuracaksanız onların imajlarını da kaydedin. 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:latest nats:2-alpine

install.sh (ya da install.ps1 veya docker-compose.yml) dosyasını ve .tar dosyalarını taşınabilir belleğe 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 beş imajı yukarıdaki etiketleriyle listeler. Docker Compose makinede zaten bulunan imajı kullanır ve hiçbir şey indirmez.

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

Taşıdığınız kurulum betiğini, Proxus'un kurulacağı klasörde çalıştırın:

bash install.sh

powershell -ExecutionPolicy Bypass -File .\install.ps1

Kurulum betiği internet erişimi gerektirmez. Bölge ayarını ve saat dilimini sorar, Edge Gateway'lerin kullanacağı makine adresini bulur ve proxus-platform/docker-compose.yml dosyasını yazar. Start the platform now? sorusuna Y yanıtını verin: yığın yüklenen imajlarla başlar.

Teslimatınızla gelen bir compose dosyası kullanıyorsanız Compose dosyasından kurun bölümündeki adımları izleyin. Oradaki docker compose up -d komutu da yüklenen imajları kullanır.

Bütün servislerin çalıştığını ve durumlarının healthy 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 docker-compose.yml dosyasında proxus-ui servisinin environment: bölümüne şu satırı ekleyin ve docker compose up -d komutunu çalıştırın:

      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, ardından merkez sunucu makinesinde:

docker load -i proxus-hub-images.tar
cd proxus-platform
docker compose up -d

Yükleme latest imajlarının yerini alır ve Compose yalnızca imajı değişen konteynerleri yeniden oluşturur. Önce Yükseltme sayfasını okuyun: neyin yedekleneceğini ve 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.