Uyumluluk ve sözleşme sürümleri

Her YTCC sürümü birlikte çalışabildiği biçimlerin ve veritabanlarının sürümlerini bilir. Bu numaralara sözleşme sürümü denir. Bir proje, veritabanı ya da yedek başka bir YTCC sürümünden geldiğinde YTCC onun sürümünü kendi sürümüyle karşılaştırır; ya kullanır, ya yükseltir ya da reddeder. YTCC'nin kendi sürümünü nerede gösterdiği için bkz. Hangi sürümü okuyorsunuz.

Sürümler nereden okunur

• Ana sayfada Settings › About (Türkçe arayüzde: Ayarlar › Hakkında) Product version (Ürün sürümü), Installation (Kurulum) ve sözleşme sürümlerini listeler: Control API (Kontrol API), Configuration schema (Konfigürasyon şeması), Project registry schema (Proje kayıt şeması), History schema (Tarihçe şeması), Project format (Proje biçimi), Page format (Sayfa biçimi), Driver API (Sürücü API) ve Messaging API (Mesajlaşma API). Kurulumun bileşenleri farklı sürümler bildirdiğinde Component versions do not match (Bileşen sürümleri uyuşmuyor) yazar ve ilgili sürümlerin adlarını verir. Aynı About penceresi ekran editöründe, çalışma ekranında ve konfigürasyon editöründe de açılır; bileşenlerin sürümlerini de listeler ve Copy information (Bilgileri kopyala) düğmesi vardır (bkz. Uygulama ayarları).
• scada-manager version ürün sürümünü, kurulumu, kontrol API'sini ve sözleşme sürümlerini yazar.
• scada-manager version --json aynısını JSON olarak yazar; alanlar product_version, install_id, control_api, install_dir, contracts ve projects'tir. Bağımsız kurulumda install_id ve install_dir null olur. projects her projeyi slug, db_name ve hist_db_name ile listeler.

Sözleşme sürümleri

Değerler bu belgenin anlattığı sürüme aittir.

Sözleşme	About'ta	Değer	Neyin sürümü
config_schema	Configuration schema	77	Proje veritabanı: sürücüler, cihazlar, sinyaller, alarmlar, alanlar ve bölgeler
registry_schema	Project registry schema	7	Bir kurulumun projelerini listeleyen kayıt veritabanı
hist_schema	History schema	1.0	Bir projenin tarihçe veritabanı
project_format	Project format	1	Sayfaları, sembolleri, popup'ları ve layout'ları tutan proje dosyası
page_format	Page format	1	Proje dosyasındaki her sayfa
format_version	—	1	Proje yedekleri ve proje paketleri
control_api	Control API	1	scada-manager'ın kontrol arayüzü
driver_api	Driver API	1	YTCC ile sürücüleri arasındaki arayüz
nats_api	Messaging API	1	YTCC servisleri arasındaki mesajlar

Hangi sürüm neyi açar

Proje veritabanı ve kayıt

Programlar ile veritabanının şema sürümü aynı olmalıdır. Bağlanmak hiçbir zaman veritabanını yükseltmez.

Veritabanı	Ne olur	Ne yapılır
Programlardan eski	Konfigürasyon editörü çalıştırılacak komutla birlikte Project database is incompatible with this version (Proje veritabanı bu sürümle uyumsuz) gösterir; projenin sürücüleri başlamaz.	Kurulum programı YTCC'yi yükseltirken veritabanlarını yükseltir. Aksi hâlde projeyi durdurup ana sayfada Upgrade… (Yükselt…) kullanın ya da scada-manager migrate <proje> çalıştırın, kayıt için scada-manager migrate --registry. Bkz. Veritabanları ve şema yükseltme.
Programlardan yeni	Aynı mesaj, update all YTCC programs together ile.	Veritabanını yükselten YTCC sürümünü kullanın.

migrate'ten sonra eski YTCC sürümleri veritabanını artık kullanamaz. Yükseltmeden önce yedek alın; bkz. Yeni sürüme yükseltme ve geri dönme.

Tarihçe veritabanı

Tarihçe veritabanı	Ne olur
Aynı ana sürüm, eski alt sürüm	Tarihçe yazıcısı onu kendisi yükseltir.
Aynı ana sürüm, yeni alt sürüm	Tarihçe yazıcısı yazmayı sürdürür; yeni sürümün eklediği sütunlar boş kalır.
Farklı ana sürüm	Tarihçe yazıcısı başlamaz, veritabanını değiştirmez ve yeniden başlatılmaz. Bu tarihçeyi yazan YTCC sürümünü kullanın.

migrate tarihçe veritabanlarını değiştirmez.

Proje ve sayfa dosyaları

Dosya	Ne olur
Eski ya da biçim sürümü yok	Normal açılır. İlk kayıtta YTCC eski proje dosyasının bir kopyasını projenin yedek klasöründe saklar, sonra dosyayı güncel biçimde kaydeder.
Yeni, ama bu sürümün okuyabileceği işaretli	Açılır, ama kaydetme reddedilir: This project was saved with a newer YTCC version; update to save it.
Yeni ve bu sürüm okuyamaz	Açılmaz: This project was saved with a newer YTCC version; update to open it.
Daha yeni sayfa biçiminde bir sayfa	Sayfa salt okunur açılır: This page was saved with a newer YTCC version and is read-only here. Update YTCC to edit it. Proje bütünüyle kaydedildiğinde sayfa değişmeden geri yazılır.

Yedekler ve proje paketleri

Bu kurallar scada-manager import ve ana sayfadaki Import project (Proje içe aktar) penceresi için geçerlidir.

Yedek ya da paket	Ne olur
Aynı ya da eski sürümle alınmış	İçe aktarılır. İçindeki eski veritabanı geri yüklenir, sonra güncel şemaya yükseltilir; Import project penceresi upgraded to {0} on import gösterir.
Daha yeni sürümle alınmış	Import project penceresi newer than this server ve The package was made with a newer YTCC version than this server; update YTCC first gösterir ve içe aktarma reddedilir.
Daha yeni format_version ya da daha yeni veritabanı şeması	İçe aktarma reddedilir. Önce YTCC'yi güncelleyin.

Bkz. Yedekleme ve geri yükleme.

Bir proje, bir sürüm

Bir proje aynı anda tek bir YTCC sürümünde çalışır. İkinci bir sürümde başlatmak Project is running in another version (Proje başka bir sürümde çalışıyor) penceresini açar; bkz. Projeyi başlatma, durdurma ve yeniden başlatma.