Sürüm Güncelleme Nedir?

Upgrade, patch ve pull işlemleri yeni versiyonları, sistemde yapılmış yamaları, yenilikleri ve en güncel dosyaları almak için yapılan işlemlerdir. Upgrade ekranı esasen sürüm güncellemeleri esnasında yapılan işlemlerin manuel olarak yapılabilmesini sağlar. Sürüm Notları sayfasında sunucunun mevcut sürümü ve yayınlanmış sürümler listelenir. Sürümlerin içine girdiğinizde yenilikler ve değişiklikleri görebilirsiniz.

Lean Sürümü Catalyst, Holistic sürümlerinden sonra ölçek, performans ve yalınlaşma felsefesi ile geliştirilmeye başlanmıştır. Esasen tüm bu sürümler aynı temel yapının üzerinde devam etmektedir. Dolayısıyla önceki sürümlerin devamıdır ve tam uyumluluk gözetilmiştir. Önceki sürümlerde olduğu gibi sunucular upgrade edilir, patch alınabilir veya pull edilebilir.

Detaylı bilgiye “Upgrade, Patch, Pull nedir?” wiki maddesi üzerinden erişebilirsiniz.

Sürüm Güncelleme Öncesi Dikkat Edilmesi Gerekenler

• Lean.23 sürümüne yükseltilecek sistemlerin upgrade öncesi ve sonrası yapılması gereken işlemleri yapmaları gerekmektedir.

• wrk_query javascript fonksiyonu tamamıyla kaldırılmış olup Plevne WAS güvenlik uygulaması tarafından bloklanmıştır. Addon veya özelleştirme amaçlı yazılan kodlarda wrk_query yerine wrk_safe_query kullanılmalıdır. 

• Mevcut sürümü pull edilebilir hale getirmek ve güncellemeleri sürekli olarak almak için Pull metoduyla upgrade özelliğini devreye almanız gerekmektedir.
  
  Bunun için yapmanız gereken sistem parametre ayarlarına giderek Git Branche Change alanındaki Current Branch değerinizin sisteminizi çalıştırmak istediğiniz sürümde olup olmadığını teyit etmek, değilse Target Branch alanına sisteminizi çalıştırmak istediğiniz sürümün bilgilerini yazmaktır.
  
  Örneğin; Current Branch: releases/Holistic.22, Target Branch: releases/Lean.23

• Git Branch ayarlarına göz atarak düzenleme yaptıktan sonra sistem parametre ayarlarında git.self_pull = true, git.branch = Mevcut branch: releases/Lean.23 olarak tanımlamalarını yapmanız gerekmektedir.
  

  

• Git Erişim Kodu: Sistem parametre ayarlarındaki git.password parametresi değeri yanındaki doğrulama ikonuna tıklandığında ya da upgrade sırasında git parola doğrulama ekranındaki doğrulama ikonuna tıklandığında; geçerli aboneliği olan sistemler için otomatik olarak verilir. Doğrulama ikonuna tıklamanıza rağmen gelmiyorsa Workcube’den isteyebilirsiniz.
  
  Workcube'ü pull etmek, patch almak veya upgrade edebilmek için geçerli bir bitbucket app password'ünüz olmalıdır. Workcube’ün kurulu olduğu dosyalar git üzerinde olmalı ve Workcube'ün size verdiği ve belirli aralıklarla güncellediği bitbucket kullanıcı kodunuz doğru girilmelidir. 
  
  İpucu: Bu erişim kodu doğru ise aşağıda gördüğünüz bitbucket ikonuna tıklarsanız app pasword'ünüzü sistem bitbucket üzerinden otomatik alacaktır. Bu işlemi bir kere yaptığınızda Workcube'den alacağınız bir sonraki erişim koduna kadar geçerli olacaktır.

  

• DB Karşılaştırma ve Fark Giderme: 19.02.2023 merge işlemi ile birlikle upgrade, patch ve pull yaparken ana sürüm ile db ve schema karşılaştırması uzak modeldb ile yapılmaktadır.
  
  Sistem Parametre Ayarlarında bu işlem için yeni tanımlar gelmiştir.
  
  * modeldb.dbname = release_workcube
  
  * modeldb.dbusername = release
  
  * modelmodeldb.dbhost = *** IP Adresini geçerli abonelere sistem otomatik verir.
  
  * modeldb.dbport = *** Portu, geçerli abonelere sistem otomatik verir.
  
  * modeldb.dbpassword = *** Passwordu, geçerli abonelere sistem otomatik verir.
  
  Bağlantı sonrası karşılaştırma işlemi otomatik olarak başlayacaktır. Bu işlem uzun sürebilir! Ayrıca model veritabanına olan bağlantı hızınız işlem süresini etkiler. Bu sürede sisteminiz bakım modunda kalacaktır! 
  
  Dilerseniz bu işlemi daha sonra manuel yapabilirsiniz. Upgrade işlemi tamamlandıktan sonra veritabanınızı karşılaştırmak için "Kontrol Paneli > System > DEV Tools > SCHEMA COMPARE"

• Kullanılan sürüm ile dağıtımdaki güncel sürüm arasındaki tüm schema, tablo, index ve view farklarını otomatik gidermek için bu geliştirimden yararlanabilirsiniz.

• Data Servisleri: Workcube Data Servislerin alınabilmesi adına sistem parametre ayarlarına "service.data_url" ve "service.upgrade_url" alanları eklenmiştir. Data servislerin alınabilmesi için bu alanlar  “https://release.workcube.com” olarak tanımlanmalıdır.
  
  Unutmayın sürümler ve veriler release üzerinden dağıtılır.
  
  

Protein Kurulu Sistemlerde Sürüm Güncelleme Öncesi Dikkat Edilmesi Gerekenler

• Kurulum sonrası parametre ayarlarınız daha önce yapılmadıysa kontrol ediniz. protein.params sayfasında params ayarlarınızı giriniz.

• Params ayarlarının çalışabilmesi için; /AddOns/Yazilimsa/Protein/reactor/ klasöründe protein.config dosyası oluşturup içerisine main dsn yazınız.

• *protein.config git ignore da olduğu için kurulum ile gelmez.

• Parametre kullanmadan çalışan sistemler upgrade edildiğinde parametre girilmeli.

Upgrade yapacaklara uyarı! Beta yayın tarihinden itibaren 14 gün süreyle Lean23 sürümü test amaçlı beta olarak yayınlanmaktadır. 

Sisteminizi en güncel sürüme yükseltmek için Self upgrade ile aşağıdaki süreçleri tamamlamanız yeterlidir.

• Standart dosyalarda yapılan geliştirimleri geri alın.

• Sistem parametre ayarlarını düzenleyin.

• Güncel sürüme geçiş yapın.

• Tüm Güncel WRO sorgularını çalıştırın

• Güncel Veritabanını karşılaştırın (Schema Compare)

• Güncel Solution, Family, Module, Object, Widget, WEX, Output Template, Process Template ve Dilleri yükleyin

• Workcube’ünüzü yeniden başlatın

Sistem Parametre Ayarları ile ilgili detaylı bilgiye “Sistem Parametre Ayarları” wiki maddesi üzerinden erişebilirsiniz.

Upgrade ile ilgili detaylı bilgiye “Master'dan Release Geçiş ve Upgrade” wiki maddesi üzerinden erişebilirsiniz.