Eski İstemciler Ayarları

HandyCafe, daha eski V3 ve V4 istemci kurulumlarıyla sorunsuz biçimde birlikte çalışır. Eski İstemciler ayar sayfası iki ayrı özelliği kontrol eder:

Çalışma Zamanı Protokolü. V3 ve V4 istemcilerin bu sunucuya kendi orijinal portları üzerinden bağlanmasını sağlayan ağ dinleyicilerini etkinleştirir.
Veritabanı Taşıması. İsteğe bağlı olarak eski bir yerel kurulumdaki üyeleri, fiyatlandırmayı, ürünleri, siparişleri, işlemleri ve kayıtları yeni HandyCafe veritabanına aktarır. Bu yalnızca Windows'ta kullanılabilir.

Bu iki özellik birbirinden bağımsızdır. Veri taşımadan çalışma zamanı desteğini açabilir, çalışma zamanı desteğini açmadan veri taşıyabilir veya ikisini birlikte yapabilirsiniz.

Çalışma Zamanı Protokolü Bölümü

Eski İstemci Desteğini Etkinleştir

Bölümün üst kısmındaki ana anahtardır. Açıkken sunucu üç ağ dinleyicisi başlatır:

Yapılandırılmış multicast grubunda bir UDP dinleyicisi.
UDP port + 2 üzerinde bir TCP komut dinleyicisi.
UDP port + 7 üzerinde bir TCP dosya aktarım dinleyicisi.

Anahtarı kapatmak, üç dinleyiciyi de atomik olarak durdurur. Kapatılmış durumdayken port numaralarını veya kodlamayı değiştirebilir, ardından değişiklikleri uygulamak için yeniden açabilirsiniz.

Yapılandırma Alanları

Alan	Varsayılan	Açıklama
Kimlik Anahtarı	HANDYCAFE	Paylaşılan 10 karakterli anahtar. Gelen ve giden her çerçeve bu dizeyi taşır. Uyuşmayan çerçeveler atılır. Tüm eski istemcileriniz aynı anahtarı kullanmalıdır.
UDP Multicast IP	230.4.4.46	İstemci keşif sinyalleri ve UDP tabanlı komut dağıtımı için kullanılan multicast grubu. Çoğu eski istemci derlemesinde sabittir.
Sunucu UDP Portu	710	Sunucunun istemci sinyalleri ve komutlar için dinlediği UDP portu. Eski istemciler bu porta gönderim yapar.
İstemci UDP Portu	711	Eski istemcilerin dinlediği UDP portu. Sunucu, bulunan istemci IP'sine tekil yönetim komutları gönderir.
Kodlama	cp1254	Çerçeve içindeki dize alanları için karakter kodlaması. Türk kurulumlarında cp1254, Batı Avrupa kurulumlarında cp1252 kullanın. Bilinmeyen değerler, sunucu günlüğünde uyarı ile cp1254'e geri döner.
Sunucu Sürümü	3.4.01	Her UDP sinyalinde yayınlanan sürüm dizesi. Bazı eski istemciler tanımadıkları sürümlerden gelen çerçeveleri reddeder. Bunu, eski sunucunuzun sürüm dizesiyle eşleştirin.
Protokol Varyantı	STE	Kullanılacak çerçeve biçimi. Aşağıdaki varyant karşılaştırmasına bakın.
Etkinliksiz Kalma Zaman Aşımı	10	Saniye. MAC başına çalışan bir bekçi. Bir istemciden bu süre içinde trafik gelmezse istemci çevrimdışı olarak işaretlenir. 10 saniyelik boşluk, 2 ya da 3 saniyede bir sinyal veren eski istemciler için uygundur.

Türetilmiş Portlar

Formun altında, sayfa türetilmiş TCP portlarını gösteren salt okunur bir satır görüntüler:

TCP Command Port: 712   File Transfer Port: 717

Bu portlar UDP sunucu portundan hesaplanır. Bunları ayrı ayrı yapılandırmazsınız. Server UDP Port değerini değiştirirseniz, türetilmiş portlar da onunla birlikte değişir.

Protokol Varyantı

Protocol Variant alanı, sunucunun kullandığı çerçeve biçimini seçer. Eski sunucunuzun nasıl derlendiğine uyan varyantı seçin.

Varyant	Ne zaman kullanılır
STE (Smart/Turbo Edition)	Modern eski kod tabanı. Çerçeve yapısına 70 baytlık bir lisans bilgisi öneki ekler. Çerçeve boyutu 1337 bayttır. Eski kurulumunuz Smart veya Turbo sürümünü kullanıyorsa bunu seçin.
Standard	Düz temel eski derleme. Lisans bilgisi öneki olmadan çerçeve boyutu 1267 bayttır. Bunu yalnızca eski kurulumunuz lisans kaydı olmayan bir Standard sürümüyse seçin.

Yanlış varyantı seçmek, çerçevelerin düşmesine veya yanlış okunmasına neden olur. Belirtiler arasında istemcilerin çevrimiçi görünmesine rağmen hiçbir komuta yanıt vermemesi veya komut verilerinin 70 baytlık ofset nedeniyle kayması yer alır.

Modern İstemcilerle Birlikte Çalışma

Eski portlar (710, 711, 712, 717), modern HandyCafe protokol portlarından (TCP 5001, 5002, 5003, UDP 5004) tamamen ayrıdır. İki protokol yığını çakışmadan aynı anda çalışır. Aynı LAN üzerinde eski ve yeni istemcileri birlikte kullanabilir ve hepsini aynı Admin Panel'den yönetebilirsiniz.

Değişiklikleri Uygulama

Çalışma Zamanı Protokolü bölümündeki tüm alanlar sayfanın altındaki genel Save düğmesiyle kaydedilir. Kaydederken sunucu:

Çalışıyorsa üç eski dinleyiciyi durdurur.
Auth key'i doğrular (boş olamaz).
Güncellenen alanlardan yeni dinleyici yapılandırmaları oluşturur.
Dinleyicileri eşzamanlı olarak yeniden başlatır.
Üçü de yeniden çevrimiçi olduğunda bir bildirim gönderir.

Bir port başka bir süreç tarafından kullanılıyorsa sunucu hata verir ve anahtar tekrar kapalı duruma döner. Güvenlik duvarınızı ve diğer servisleri netstat ile kontrol edin ve boş bir port aralığı seçin.

Veritabanı Taşıması Bölümü (Yalnızca Windows)

Bu özellik yalnızca HandyCafe Windows üzerinde çalışırken kullanılabilir. macOS ve Linux'ta bölümde şu uyarı görünür: "Database migration is supported on Windows only."

Algılama

Sayfa açıldığında sunucu sisteminizde eski bir kurulum arar. Algılama şu konumlara bakar:

Kayıt defteri ve Program Files\\HandyCafe ile C:\\HandyCafe gibi tipik kurulum yolları.
Kurulum klasörü yanındaki veritabanı dosyası.
Kurulum dizinindeki yapılandırma INI dosyaları.

Algılama başarılı olduğunda sayfada şu bilgiler gösterilir:

Etiket	Anlamı
Kurulum Yolu	Eski kurulumun diskte bulunduğu yer.
Veritabanı Yolu	Eski veritabanı dosyasının tam yolu.
Sunucu Sürümü	Eski yapılandırmadan ayrıştırılan sürüm.
INI Dosyası Sayısı	Algılanan yapılandırma dosyalarının sayısı. Kurulumun eksiksiz olup olmadığını kabaca doğrulamak için kullanışlıdır.

Hiç kurulum algılanmazsa sayfada "No legacy installation detected." yazar. Yine de çalışma zamanı desteğini açabilirsiniz; taşıma özelliğinin içe aktaracağı bir şey olmayacaktır.

Taşıma Durumu

Sayfa taşıma geçmişini izler:

Durum	Anlamı
never	Henüz bir taşıma çalıştırmadınız.
in_progress	Şu anda bir taşıma çalışıyor. Bu durumda sunucuyu kapatmayın.
completed	En son taşıma uyarısız tamamlandı.
completed_with_warnings	En son taşıma tamamlandı ancak bazı kayıtlar atlandı (örneğin kodlama hataları veya bozuk tarihler nedeniyle). Devam etmeden önce uyarıları inceleyin.
undone	En son taşıma geri alındı.

İlk başarılı çalıştırmadan sonra Start Migration düğmesinin etiketi Re-run Migration olarak değişir.

Neler Taşınır

Tablo	Açıklama
Members	Ad, iletişim bilgileri ve hesap bakiyeleri olan müşteri kayıtları.
Pricing	Fiyat tabloları ve saat bazlı oranlar.
Products	Ürün kataloğu girdileri.
Orders	Oturum referanslarıyla birlikte sipariş geçmişi.
Transactions	Zaman damgaları, tutarlar ve ödeme yöntemlerini içeren muhasebe girdileri.
Logs	Eski veritabanından alınan denetim ve uyarı kayıtları.

"Dosyalar Silinmez" Garantisi

Sayfada mavi bir uyarı görünür: "The original database files are not deleted. You can safely delete them once migration is confirmed." Taşıma, kaynak üzerinde salt okumadır. Taşıma işlemini birden fazla kez çalıştırırsanız bile orijinal eski veritabanı dokunulmadan kalır. Bu, içe aktarma işlemini denemenize, sayaçları incelemenize ve risk almadan geri dönmenize imkan verir.

Başlat, Yeniden Çalıştır ve Geri Al

Start Migration. Bir ilerleme penceresi açar. Pencere, içe aktarma çalışırken geçerli aşamayı ve kayıt sayılarını gösterir. Bu sırada HandyCafe'yi kapatmayın.
Re-run Migration. Başarılı bir çalıştırmadan sonra kullanılabilir. İçe aktarmayı baştan çalıştırır. Yeni içe aktarma, HandyCafe içindeki önceki verilerin yerini alır.
Undo Migration. Başarılı bir çalıştırmadan sonra kullanılabilir. Bir onay iletişim kutusu açar. Onaylarsanız taşınan her satır HandyCafe'den silinir. Eski kaynak etkilenmez. Geri alma sonrası durum never olur.

Uyarılarla Tamamlandı

Taşıma completed_with_warnings ile biterse, sarı bir bant ve Details bağlantısı görünür. Açılan listede atlanan kayıtları ve nedenlerini görebilirsiniz. Yaygın nedenler:

Kodlama uyumsuzluğu. Kaynak satır, yapılandırılan kodlamada düzgün çözülemeyen karakterler içerir. Kodlama alanını (cp1254 veya cp1252) değiştirin ve taşımayı yeniden çalıştırın.
Bozuk tarihler. Bazı eski kayıtlarda geçersiz zaman damgaları vardır. Bunlar atlanır, böylece geçerli satırlar yine de içe aktarılır.
Çift anahtarlar. Aynı tanımlayıcıya sahip bir kayıt HandyCafe'de zaten vardır. Taşıma mevcut kaydı korur ve kopyayı atlar.

İpuçları

Taşıma çalıştırmadan önce eski sunucuyu durdurun. Eski sistem veritabanına yazmaya devam ediyorsa içe aktarma eski veya yarım kalmış verileri görebilir.
İlk taşıma öncesinde Encoding alanını eski yerel ayarınıza eşleyin. Veriler içe aktarıldıktan sonra bunu değiştirmek, önceden bozulmuş adları geriye dönük olarak düzeltmez.
Her zaman önce bir test taşıması yapın. "Last Counts" altındaki kayıt sayılarını kontrol edin ve yeni sisteme geçmeden önce birkaç üye ve işlem satırını örnekleyin.
Geçiş sürecinde eski istemcilerinizi bağlı tutmak için çalışma zamanı desteğini açın. Böylece eski sunucuyu emekliye ayırmadan önce yeni sunucunun onları birebir desteklediğini doğrulayabilirsiniz.
Server UDP Port değerini değiştirirseniz, bununla birlikte türetilmiş komut ve dosya aktarım portlarının da değiştiğini unutmayın. Güvenlik duvarı kurallarını buna göre güncellemeniz gerekir.