Yükseltme

Bu kılavuzu tamamladığınızda merkez sunucu ve Edge Gateway'ler yeni sürümle çalışır. Cihazlar, alarm kuralları, kullanıcılar ve saklanan değerler olduğu gibi korunur. Veritabanı betiği çalıştırmanız gerekmez; merkez sunucu kendi veritabanını kendisi günceller.

Başlamadan önce

• Yükseltmeden hemen önce alınmış bir yedek. Kurulum betiği bunu sizin için alır; aksi halde Yedekleme ve geri yükleme sayfasına bakın. Yedek olmadan eski sürüme dönülemez.
• Yeni sürümün sürüm notlarını okuyun.
• Bir bakım aralığı planlayın. Edge Gateway'ler yeniden başlarken cihazlar okunmaz.

Neler değişir, neler kalır

2.0.0'a yükseltme

2.0.0 sürümüyle platformun tüm bağlantılarında TLS açılır. Sertifikalar Sertifika deposundan gelir. Aşağıdaki standart yükseltme adımlarına ek olarak şu adımları da planlayın.

Yükseltmeden önce

1. Yedeği her zamanki gibi alın. Yapılandırma klasöründe (config birimi ya da Kubernetes'te merkez sunucunun ortak yapılandırma diski) artık keys/STORE/certificate-store.key dosyası da bulunur. Sertifika deposundaki özel anahtarlar bu anahtarla şifrelenir ve çözülür. Dosya, 2.0.0 ilk kez başladığında oluşur. Bu yüzden o andan itibaren her yedeğe yapılandırma klasörünü de ekleyin. Anahtarı PROXUS_CERTIFICATE_STORE_KEY ile veriyorsanız bu değeri güvenli bir yerde saklayın.
2. Güvenlik duvarında yeni portları açın. Merkez sunucu makinesinde 8443 (varsayılan olarak açık olan HTTPS) portunu açın. Cihazların Edge Gateway'deki MQTT sunucusuna veri gönderdiği Edge Gateway makinelerinde ise 8883 (TLS ile MQTT) portunu açın.

Merkez sunucu başladıktan sonra

3. Merkez sunucunun NATS sunucusunu bir kez yeniden başlatın. NATS sunucusu böylece TLS ile başlar (kurulum betiği bunu kendisi yapar):
   • Docker: docker restart hub-server
   • Kubernetes: hub-server podlarını yeniden başlatın, örneğin kubectl -n proxus-ha rollout restart statefulset/hub-server (yerel çeşitte namespace proxus).
4. Her Edge Gateway'in kurulum komutunu yeniden çalıştırın. Bağlantılar > Edge Gateway'ler ekranında Edge Gateway'i açın, Kur'a tıklayın ve üretilen yeni komutu Edge Gateway'in makinesinde çalıştırın. 2.0.0'dan önce kurulan Edge Gateway'ler bu adım tamamlanana kadar merkez sunucuya bağlanamaz. Bu sürede cihazları okumaya devam eder, veriyi ara bellekte tutar (varsayılan olarak 48 saat) ve bağlantı kurulunca gönderir. Ayrıntılar için Edge Gateway kurma sayfasına bakın.
5. Tarayıcıların merkez sunucunun HTTPS sertifikasına güvenmesini istiyorsanız eski sertifikayı yenileyin. Güvenlik > Sertifika deposu ekranında Proxus (Self-Signed) sertifikasını seçin ve Yenile'ye tıklayın. Yeni sertifikayı platform CA'sı verir ve sertifika merkez sunucunun adlarını kapsar. Ardından platform CA'sını kullanıcıların bilgisayarlarına yükleyin (CA'yı indir). Ayrıntılar için Sertifikalar sayfasına bakın.

Artık doğrulanan bağlantıları kontrol edin

6. OPC UA: Güvenlik modu İmzala ya da İmzala ve şifrele olan cihazlar, sunucunun sertifikası depoda güvenilir olarak işaretlenene kadar veri göndermez. Güvenlik > Sertifika deposu ekranını açın, Güven durumu alanını Reddedilenler olarak ayarlayın ve tanıdığınız her sunucu için Güven'e tıklayın. Cihazlar bir sonraki denemede bağlanır. Güvenlik modu Yok olan cihazlar bu değişiklikten etkilenmez.
7. Veri hedefleri: Kendinden imzalı ya da özel bir CA'dan alınmış sertifika kullanan sunuculara bağlanan hedefler (örneğin kendi MQTT sunucunuz, Splunk ya da bir AWS IoT uç noktası) önceden sertifika denetlenmediği için çalışıyordu. Artık bu bağlantılar reddedilir. Sunucunun CA'sını Sertifika deposuna yükleyin ve hedefin Güvenilen sunucu sertifikası alanında bu CA'yı seçin. Ayrıntılar için Veri hedefleri sayfasına bakın.

Yeri değişen ekranlar

• Kullanıcılar, Roller ve Sertifika deposu artık Raporlama ile Yönetim arasındaki yeni Güvenlik menüsünde yer alır. Bilgilerim ekranı Yönetim menüsünde kalır.

Docker kurulumunu yükseltin

Kurulum betiğiyle

proxus-platform klasörünü içeren klasörde betiği yeniden çalıştırın ve Update to … (yeni sürüm) seçeneğini seçin:

curl -fsSL https://proxus.io/install.sh | bash

irm https://proxus.io/install.ps1 | iex

Betik sırasıyla şunları yapar:

1. Yeni sürümün compose dosyalarını indirir ve hem sürümün sağlama toplamlarıyla hem de ayarlarınızla (.env) ve kendi değişikliklerinizle (docker-compose.override.yml) uyumunu kontrol eder.

2. Yeni imajları Proxus çalışmaya devam ederken indirir. Buraya kadar bir şey başarısız olursa hiçbir şey değişmemiştir.

3. Devam etmek için onay ister, Proxus'u durdurur ve yapılandırmasının (ayarlar, yapılandırma veritabanı, eklentiler) yedeğini sağlama toplamlarıyla birlikte proxus-platform/backups/ klasörüne alır. Önce yeterli boş disk alanı olup olmadığını kontrol eder. Telemetri veritabanı ve mesaj sunucusunun verisi kopyalanmaz ve değiştirilmez: yeni sürüm onları kullanmaya devam eder. Onları kendi takviminizle yedekleyin.

4. Yeni sürümü başlatır; bütün servisler sağlıklı olana ve merkez sunucu yeni imajları çalıştırana kadar bekler. Merkez sunucu veritabanını bu ilk açılışta günceller; büyük bir veritabanında bu zaman alır.

5. Sürümün yeni imajlar dışında gerektirdiği adımları uygular (2.0.0 için: mesaj sunucusunu yeniden başlatmak).

6. adımdan merkez sunucu yeniden sağlıklı olana kadar, genellikle birkaç dakika, cihazlar okunmaz. Ayarlarınız, override dosyanız, Keycloak, yığının adı ve birimleri korunur.

Yeni sürüm düzgün başlamazsa betik geri dönmeyi önerir; siz hayır demedikçe yedeği geri yükler ve önceki sürümü yeniden başlatır. Çalıştırmanın kaydı (proxus-platform/logs/) ve merkez sunucunun çıktısı, Proxus desteğinin ihtiyaç duyduğu bilgilerdir.

Güncelleme yarıda kesildiyse (terminal kapandı, elektrik gitti) betiği yeniden çalıştırın: bitmemiş güncellemeyi görür ve yedeğiyle önceki sürüme dönmeyi ya da yeni sürümü yeniden başlatmayı önerir.

Sonradan geri dönmek için betiği çalıştırın ve Restore a backup seçeneğini seçin. O yedekten sonra değişen cihazlar, kullanıcılar ve ayarlar yedekteki haliyle değiştirilir; saklanan değerler korunur. Eski bir sürüme dönüş her zaman bir yedekle olur: eski bir sürüm, yeni sürümün güncellediği veritabanını okuyamaz.

Gözetimsiz bir güncelleme için, örneğin bir bakım görevinden, update --yes ekleyin:

cd /opt && curl -fsSL https://proxus.io/install.sh | bash -s -- update --yes

Yalnızca daha yeni bir sürüm varsa günceller; yeni sürüm başlamazsa kendiliğinden geri döner.

Ön izleme sürümünü deneyin

Proxus bir sürümü yayımlamadan önce, onu erken denemek isteyen iş ortakları için ön izleme sürümleri (örneğin 2.1.0-preview.1) yayımlayabilir. Kurulum betiği bir ön izleme sürümünü hiçbir zaman kendiliğinden önermez ve ön izleme Docker Hub'da hiçbir zaman latest olmaz: yalnızca adını vererek alırsınız. Aynı yedek ve otomatik geri dönüşle güncellenir:

curl -fsSL https://proxus.io/install.sh | bash -s -- update --version 2.1.0-preview.1

Windows'ta: $env:PROXUS_COMMAND='update'; $env:PROXUS_VERSION='2.1.0-preview.1'; irm https://proxus.io/install.ps1 | iex. Ön izleme sürümleri sürümler sayfasında "Pre-release" olarak görünür. Sürümün kendisi yayımlandığında normal bir güncelleme merkez sunucuyu ön izlemeden ona taşır. Ön izlemeleri önce test sistemlerinde kullanın: bir ön izlemeden önceki bir sürüme dönüş yalnızca güncellemeden önce alınan yedekle olur.

Kurulum betiği olmadan

Compose dosyasıyla kendiniz yönettiğiniz bir kurulum için:

1. Bir yedek alın.

2. Kurulum klasöründe docker-compose.yml dosyasını yeni sürümünkiyle değiştirin (sürümden alın) ve yeni sürümü .env dosyasına yazın:

   .env

   PROXUS_VERSION=2.1.0

3. İmajları indirin, ardından konteynerleri yeniden oluşturun:

   docker compose pull
   docker compose up -d

   Compose yalnızca imajı ya da ayarları değişen konteynerleri yeniden oluşturur. Birimler korunur.

4. Merkez sunucuyu tarayıcıda açın ve oturum açın. Menünün altındaki sürüm bilgisini (Sürüm:) kontrol edin ve Yönetim > Sistem günlükleri ekranında hata olup olmadığına bakın.

Merkez sunucu oturum açma sayfası yerine bir hata gösterirse çıktısını kaydedin (docker compose logs proxus-ui), önceki sürümü yeniden .env dosyasına yazın, önceki docker-compose.yml dosyasını geri koyun, yedeği geri yükleyin ve yığını başlatın.

Makinenin internet erişimi yoksa docker compose pull yerine size verilen imaj dosyalarını docker load -i <file> ile yükleyin. Bkz. İnternet erişimi olmadan kurulum.

Kubernetes kurulumunu yükseltin

Manifestler sabit bir etiketle imagePullPolicy: IfNotPresent kullanır. İmaj bir düğümde zaten varsa düğüm yeni imajı kendiliğinden indirmez.

1. Yapılandırma birimleri dahil yedeği alın.
2. Kustomization dosyanızda yeni imaj etiketini bir images: girdisiyle tanımlayın ya da imagePullPolicy: Always olarak ayarlayın.
3. Aşağıdaki komutlarla değişikliği uygulayın ve podları yeniden başlatın.
4. Docker'daki gibi oturum açın; sürümü ve sistem günlüklerini kontrol edin.

kubectl apply -k Deployment/kubernetes/ha
kubectl -n proxus-ha rollout restart deployment/proxus-ui deployment/proxus-server-gateway-1

Merkez sunucu kopyaları tek tek yenilenir; bu sırada web arayüzü açık kalır. Edge Gateway podu ise durdurulup yeniden başlatılır.

Edge Gateway'leri yükseltin

Merkez sunucunun kendi Edge Gateway'i SYSTEM, yukarıdaki yığının bir parçasıdır ve yığınla birlikte yükseltilir. Her uzak Edge Gateway'i merkez sunucudan hemen sonra yükseltin. Merkez sunucu ile Edge Gateway'ler aynı sürümde çalışmalıdır.

Kurulum programı her Edge Gateway makinesinde Edge Gateway'i /opt/proxus/proxus-edge-<ID> klasörüne kurar. Buradaki <ID>, Edge Gateway'in kimliğidir. Yeni imajı bu klasörde indirin ve konteyneri yeniden oluşturun:

cd /opt/proxus/proxus-edge-3
sudo docker compose -p proxus-edge-3 -f compose.yaml pull
sudo docker compose -p proxus-edge-3 -f compose.yaml up -d

Diğer bir yol, merkez sunucuda Edge Gateway için yeni bir kurulum komutu üretip bu komutu makinede yeniden çalıştırmaktır. Komut konteynerleri yeniler ve Edge Gateway'e yeni kimlik bilgileri verir; eski kimlik bilgileri geçersiz olur. Ayrıntılar için Edge Gateway kurma sayfasına bakın.

Bağlantılar > Edge Gateway'ler ekranında her Edge Gateway'in yeniden Bağlı durumuna geçtiğini kontrol edin.

Yükseltmeden sonra

• Marka ayarlarını kullanıyorsanız logonuzun göründüğünü kontrol edin. Görünmüyorsa logoyu yeniden yükleyin.
• Sürüm notlarında yeni yapılandırma anahtarlarını inceleyin ve gerekenleri ayarlayın.

Sonraki adımlar

• Yedekleme ve geri yükleme: bir sonraki yükseltmeden önce düzenli yedek alma.
• İzleme: yükseltmeden sonra çalışma durumunu ve günlükleri takip etme.